Read-SCVMHost

  • Referência
Módulo:
VirtualMachineManager

Atualiza as propriedades do host da máquina virtual no Console do VMM.

Syntax

Read-SCVMHost
    [-VMHost] <Host>
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]
Read-SCVMHost
    [-VMHost] <Host>
    [-RefreshOutOfBandProperties]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Description

O cmdlet Read-SCVMHost atualiza as propriedades de um host de máquina virtual para que o console do VMM (Virtual Machine Manager) exiba informações atualizadas sobre o host.

As propriedades do host que este cmdlet atualiza incluem:

  • Name
  • Sistema operacional
  • Status (como Responder)
  • Volumes de host (normalmente, adição ou remoção de letras de unidade, pontos de montagem, bem como espaço usado e disponível)
  • Adaptadores de rede (adição ou remoção)

Exemplos

Exemplo 1: atualizar informações sobre um host específico

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01" 
PS C:\> Read-SCVMHost -VMHost $VMHost

O primeiro comando obtém o objeto host chamado VMHost01 e armazena o objeto na variável $VMHost.

O segundo comando atualiza as propriedades do VMHost01 para que as informações atuais sobre esse host apareçam no Console do VMM.

Exemplo 2: Atualizar informações sobre todos os hosts

PS C:\> Get-SCVMHost -VMMServer "VMMServer01.Contoso.com" | Read-SCVMHost

Esse comando atualiza informações sobre todos os hosts gerenciados pelo VMMServer01 para que as informações atuais sobre cada host apareçam no Console do VMM.

Exemplo 3: atualizar informações sobre um determinado host por meio de seu canal OOB

PS C:\> Get-SCVMHost -ComputerName "VMHost02" | Read-SCVMHost -RefreshOutOfBandProperties

Esse comando atualiza informações sobre o host VMHost02 usando sua interface fora de banda para que as informações atuais sobre o host apareçam no console do VMM.

Parâmetros

-JobVariable

Especifica que o andamento do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.

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

-PROTipID

Especifica a ID da dica de Desempenho e Otimização de Recursos (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

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

-RefreshOutOfBandProperties

Atualiza as propriedades de hardware do computador disponíveis por meio do BMC (controlador de gerenciamento de placa base fora de banda). Esse processo é diferente da lógica de atualização de host regular, pois o atualizador de host passa pelo agente do VMM dentro do sistema operacional (em banda). As propriedades atualizadas por meio do BMC são diferentes daquelas no atualizador em banda.

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

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne imediatamente ao shell de comando.

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

-VMHost

Especifica um objeto host de máquina virtual. O VMM dá suporte a hosts Hyper-V, hosts ESX VMware e hosts Citrix XenServer.

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

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

Saídas

Host

Esse cmdlet retorna um objeto Host .