Share via

Read-SCVirtualMachine

  • Referência
Módulo:
VirtualMachineManager

Atualiza as propriedades de uma máquina virtual para que a consola VMM apresente informações atualizadas sobre a máquina virtual.

Syntax

Read-SCVirtualMachine
    [-VM] <VM>
    [-Force]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]
Read-SCVirtualMachine
    [-VMHost] <Host>
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Description

O cmdlet Read-SCVirtualMachine atualiza as propriedades de uma máquina virtual de modo a que a consola Virtual Machine Manager (VMM) apresente informações atualizadas sobre a máquina virtual. As propriedades atualizadas incluem Nome, Estado, Anfitrião, Proprietário, CPUAverage, Serviço, Sistema Operativo e outras propriedades.

Exemplos

Exemplo 1: Atualizar informações sobre uma máquina virtual específica

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Read-SCVirtualMachine -VM $VM

O primeiro comando recebe o objeto da máquina virtual chamado VM01, e depois armazena esse objeto na variável $VM.

O segundo comando atualiza as propriedades da máquina virtual armazenada em $VM. Depois de este comando terminar com sucesso, apresenta informações atuais sobre esta máquina virtual.

Exemplo 2: Refrescar todas as máquinas virtuais dos anfitriões cujo nome corresponde à cadeia especificada

PS C:\> $VMs = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | Where-Object { $_.VMHost.Name -Match "VMM" }
PS C:\> $VMs | Read-SCVirtualMachine

O primeiro comando obtém todos os objetos de máquina virtuais do VMMServer01 implantados em anfitriões cujo nome contém o VMM de cadeia e, em seguida, armazena esses objetos de máquina virtual na matriz $VMs.

O segundo comando atualiza as propriedades de cada objeto de máquina virtual armazenado em $VMs.

Parâmetros

-Force

Força o comando a funcionar sem pedir confirmação do utilizador.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

Especifica uma variável em que o progresso do trabalho é rastreado e armazenado.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

Especifica um nome de utilizador. Este cmdlet funciona em nome do utilizador que este parâmetro especifica.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

Especifica uma função de utilizador. Para obter uma função de utilizador, utilize o cmdlet Get-SCUserRole . Este cmdlet funciona em nome da função de utilizador que este parâmetro especifica.

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

Especifica o ID da ponta de otimização de desempenho e recursos (ponta PRO) que desencadeou esta ação. Este parâmetro permite-lhe auditar dicas PRO.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

Indica que o trabalho funciona assíncronamente para que o controlo volte imediatamente à concha de comando.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VM

Especifica um objeto de máquina virtual.

Type:VM
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMHost

Especifica um objeto hospedeiro de máquina virtual. A VMM suporta anfitriões Hiper-V, anfitriões VMware ESX e anfitriões Citrix XenServer.

Para obter mais informações sobre cada tipo de hospedeiro, consulte o cmdlet Add-SCVMHost .

Type:Host
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Saídas

VirtualMachine

Notas

  • Este cmdlet requer um objeto de máquina virtual, que pode ser recuperado utilizando o cmdlet Get-SCVirtualMachine .