Update-SCVMMManagedComputer

Update-SCVMMManagedComputer

Updates VMM agent software installed on a Windows-based managed computer.

構文

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

詳細説明

The Update-SCVMMManagedComputer cmdlet updates Virtual Machine Manager (VMM) agent software installed on a Windows-based managed computer to the current version of the software.

If you upgrade your VMM management server to a later version of the VMM service, afterward you can use this command to update agent software on computers that are managed by that VMM management server.

Managed computers that you can update by using this cmdlet include:

-- Hyper-V hosts
-- Windows-based library servers
-- Windows-based P2V source computers

パラメーター

-Credential<VMMCredential>

Specifies a credential object or, for some cmdlets, a Run As account object that contains the user name and password of an account that has permission to perform this action. Or, in the case of Restart-SCJob, has permission to complete a restarted task.

For more information about the PSCredential object, type Get-Help Get-Credential. For more information about Run As accounts, type Get-Help New-SCRunAsAccount.

-JobVariable<String>

Specifies that job progress is tracked and stored in the variable named by this parameter.

-PROTipID<Guid]>

Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

-RunAsynchronously

Indicates that the job runs asynchronously so that control returns to the command shell immediately.

-VMMManagedComputer<VMMManagedComputer>

Specifies a computer object that is managed by VMM.

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

例

Example 1: Update all managed computers

The first command prompts you to provide credentials with appropriate permissions to perform this operation, and then stores the credentials in the $Credential variable.

The second command gets all computer objects that are currently managed by VMM, and then passes each object to the ForEach-Object cmdlet. That cmdlet uses the Update-SCVMMManagedComputer cmdlet to update the agent software on each managed computer. As this command is processed, $Credential provides your credentials to Update-SCVMMManagedComputer. Note: This example assumes that no managed computers are located in a perimeter network.

For more information about the standard Windows PowerShell ForEach-Object cmdlet, type Get-Help ForEach-Object.

PS C:\> $Credential = Get-Credential
PS C:\> Get-SCVMMManagedComputer | ForEach-Object { Update-SCVMMManagedComputer -VMMManagedComputer $_ -Credential $Credential -RunAsynchronously }

Example 2: Update a specific host

The first command prompts you to provide credentials with appropriate permissions to perform this operation, and then stores the credentials in the $Credential variable.

The second command gets the managed host object named VMHost01, and then stores the object in the $VMMManagedHost variable.

The last command updates the agent software on VMHost01. As this command is processed, $Credential provides your credentials to Update-SCVMMManagedComputer.

PS C:\> $Credential = Get-Credential
PS C:\> $VMMManagedHost = Get-SCVMMManagedComputer -ComputerName "VMHost01.Contoso.com"
PS C:\> Update-SCVMMManagedComputer -VMMManagedComputer $VMMManagedHost -Credential $Credential

関連トピック

Get-SCVMMManagedComputer

Register-SCVMMManagedComputer

New-SCRunAsAccount

Restart-SCJob