Update-SCVMMManagedComputer
windows ベースのマネージド コンピューターにインストールされている VMM エージェント ソフトウェアを更新します。
構文
Update-SCVMMManagedComputer
[-VMMManagedComputer] <VMMManagedComputer>
-Credential <VMMCredential>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
説明
Update-SCVMMManagedComputer コマンドレットは、Windows ベースのマネージド コンピューターにインストールされている Virtual Machine Manager (VMM) エージェント ソフトウェアを現在のバージョンのソフトウェアに更新します。
VMM 管理サーバーを VMM サービスの新しいバージョンにアップグレードする場合は、後でこのコマンドを使用して、その VMM 管理サーバーによって管理されているコンピューター上のエージェント ソフトウェアを更新できます。
このコマンドレットを使用して更新できる管理対象コンピュータには、次のものが含まれます。
- Hyper-V ホスト
- Windows ベースのライブラリ サーバー
- Windows ベースの P2V ソース コンピューター
Update-SCVMMManagedComputer コマンドレットを使用すると、ドメインに参加している信頼されたホストと信頼されていないドメインに参加しているホスト上の VMM エージェント ソフトウェアを更新できますが、境界ネットワーク上にあるホストでは更新できません。
例
例 1: すべてのマネージド コンピューターを更新する
PS C:\> $Credential = Get-Credential
PS C:\> 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: 特定のホストを更新する
PS C:\> $Credential = Get-Credential
PS C:\> $VMMManagedHost = Get-SCVMMManagedComputer -ComputerName "VMHost01.Contoso.com"
PS C:\> Update-SCVMMManagedComputer -VMMManagedComputer $VMMManagedHost -Credential $Credential
最初のコマンドでは、この操作を実行するための適切なアクセス許可を持つ資格情報を指定するように求め、資格情報を $Credential 変数に格納します。
2 番目のコマンドは、VMHost01 という名前のマネージド ホスト オブジェクトを取得し、そのオブジェクトを $VMMManagedHost 変数に格納します。
最後のコマンドは、VMHost01 上のエージェント ソフトウェアを更新します。 このコマンドが処理されると、$Credentialは Update-SCVMMManagedComputer に資格情報を提供します。
パラメーター
-Credential
資格情報オブジェクトを指定するか、一部のコマンドレットでは、このアクションを実行するアクセス許可を持つアカウントのユーザー名とパスワードを含む実行アカウント オブジェクトを指定します。 または、 Restart-SCJob の場合、再起動されたタスクを完了するためのアクセス許可を持ちます。
PSCredential オブジェクトの詳細については、「.」と入力しますGet-Help Get-Credential
。
実行アカウントの詳細については、「.」と入力します Get-Help New-SCRunAsAccount
。
Type: | VMMCredential |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-JobVariable
ジョブの進行状況を追跡して、このパラメーターで示す名前の変数に保管するように指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMMManagedComputer
VMM によって管理されるコンピューター オブジェクトを指定します。
Type: | VMMManagedComputer |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |