SCVMM 2016 UR5 で利用可能なコマンドレット (Update-SCVMMManagedComputer) について

スポンサーリンク
Microsoft Store (マイクロソフトストア)

System Center 2016 – Virtual Machine Manager (SCVMM 2016) に触れる機会が多くなり、Virtual Machine Manager Command Shell を使った設定や、情報取得、および管理することが増えてきたので、備忘録として各コマンドレットの概要を日本語化 (意訳) しました。

ここでは Update-SCVMMManagedComputer コマンドレットのヘルプ情報について、SCVMM2016 UR5 の Virtual Machine Manager Command Shell 上で「Update-SCVMMManagedComputer」コマンドレットの -Full オプションを用いて実行した結果を元に記載しています。
※SCVMM 2016 UR5 で利用可能なコマンドレット一覧については、「System Center 2016 – Virtual Machine Manager で利用できるコマンドレットについて」を参照。

Update-SCVMMManagedComputer コマンドレット

名前

Update-SCVMMManagedComputer

概要

Windows ベースの管理されたコンピューターにインストールされた VMM エージェント ソフトウェアを更新します。

構文

Update-SCVMMManagedComputer
 [-VMMManagedComputer] <VMMManagedComputer>
 -Credential <VMMCredential>
 [-JobVariable <String>]
 [-PROTipID <Guid>]
 [-RunAsynchronously]
 [<CommonParameters>]

説明

Update-SCVMMManagedComputer コマンドレットは、Windows ベースの管理対象コンピューターにインストールされている Virtual Machine Manager (VMM) エージェント ソフトウェアを、現在のバージョンのソフトウェアに更新します。

VMM 管理サーバーをそれ以降のバージョンの VMM サービスにアップグレードする場合、このコマンドを用いてそのV MM 管理サーバーによって管理されているコンピューター上のエージェント ソフトウェアを更新することが可能です。

このコマンドレットを使用して更新可能な管理対象コンピューターには、次のとおり :

  • Hyper-V ホスト
  • Windows ベースのライブラリ サーバー
  • Windows ベースの P2V ソース コンピューター

Update-SCVMMManagedComputer コマンドレットを用いて、ドメインに参加した信頼済みホストおよび信頼されていないドメインに参加したホスト上の VMM エージェント ソフトウェアを更新できますが、境界ネットワーク上のホストでは更新できません。

パラメーター

-Credential <VMMCredential>

資格情報オブジェクトもしくは一部のコマンドレットで、この操作を実行するアクセス許可を持つアカウントのユーザー名とパスワードを含む Run As アカウント オブジェクトを指定します。もしくは、Restart-SCJob の場合、再起動したタスクを完了するためのアクセス許可が必要となります。

必須true
位置named
既定値None
パイプライン入力を許可するTrue (ByValue)
ワイルドカード文字を許可するfalse

-JobVariable <String>

ジョブの進行状況を追跡し、このパラメーターで指定された変数に格納する場合に指定します。

必須false
位置named
既定値None
パイプライン入力を許可するFalse
ワイルドカード文字を許可するfalse

-PROTipID <Guid>

このアクションにトリガーされるパフォーマンスとリソースの最適化のヒント (PRO ヒント) を指定します。このパラメーターは、PRO ヒントを監査することができます。

必須false
位置named
既定値None
パイプライン入力を許可するFalse
ワイルドカード文字を許可するfalse

-RunAsynchronously [<SwitchParameter>]

ジョブが非同期で実行、制御がすぐにコマンド シェルに戻されるかどうかを指定します。

必須false
位置named
既定値False
パイプライン入力を許可するFalse
ワイルドカード文字を許可するfalse

-VMMManagedComputer <VMMManagedComputer>

VMM によって管理されているコンピューター オブジェクトを指定します。

必須true
位置0
既定値None
パイプライン入力を許可するTrue (ByValue)
ワイルドカード文字を許可するfalse

<CommonParameters>

このコマンドレットは、次の共通パラメーターをサポートします: Verbose、Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、OutBuffer, PipelineVariable、および OutVariable。詳細については、about_CommonParameters を参照してください。

入力

出力

メモ

例 1 : すべての管理対象コンピューターを更新する

コマンド
$Credential = Get-Credential
Get-SCVMMManagedComputer | ForEach { Update-SCVMMManagedComputer -VMMManagedComputer $_ -Credential $Credential -RunAsynchronously }
コマンドの説明

最初のコマンドは、この操作を実行するための適切な権限を資格情報に入力するように求め、その資格情報を $Credential 変数に格納します。

2 番目のコマンドは、現在 VMM によって管理されているすべてのコンピューター オブジェクトを取得し、各オブジェクトを ForEach-Object コマンドレットに渡します。このコマンドレットは、Update-SCVMMManagedComputer コマンドレットを用いて各管理対象コンピューターのエージェント ソフトウェアを更新します。このコマンドが処理されると、$Credential は Update-SCVMMManagedComputer に資格情報を提供します。

注 : この例では、管理対象コンピュータがー境界ネットワークに配置されていないことを前提としています。

ForEach-Object コマンドレットに関する詳細な情報は、Get-Help ForEach-Object を実行してください。

例 2 : 特定のホストを更新する

コマンド
$Credential = Get-Credential
$VMMManagedHost = Get-SCVMMManagedComputer -ComputerName "VMHost01.Contoso.com"
Update-SCVMMManagedComputer -VMMManagedComputer $VMMManagedHost -Credential $Credential
コマンドの説明

最初のコマンドは、この操作を実行するための適切な権限を資格情報に入力するように求め、その資格情報を $Credential 変数に格納します。

2 番目のコマンドは、管理対象ホスト オブジェクト “VMHost01.Contoso.com” を取得し、そのオブジェクトを $VMMManagedHost 変数に格納します。

最後のコマンドは、VMHost01 のエージェント ソフトウェアを更新します。このコマンドが処理されると、$Credential は Update-SCVMMManagedComputer に資格情報を提供します。

関連するリンク

  • Add-SCVMMManagedComputer
  • Get-SCVMMManagedComputer
  • Read-SCVMMManagedComputer
  • Register-SCVMMManagedComputer
  • Remove-SCVMMManagedComputer
  • Set-SCVMMManagedComputer

参考