Partilhar via

Read-SCVMHost

  • Referência
Módulo:
VirtualMachineManager

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

Sintaxe

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 Virtual Machine Manager (VMM) exiba informações atualizadas sobre o host.

As propriedades de host que este cmdlet atualiza incluem:

  • Designação
  • Sistema Operativo
  • Status (como Respondendo)
  • 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

Este 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

Este comando atualiza as 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 progresso do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PROTipID

Especifica a ID da dica de Otimização de Desempenho e Recursos (dica PRO) que disparou essa ação. Este parâmetro permite auditar dicas PRO.

Tipo:Guid
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RefreshOutOfBandProperties

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RunAsynchronously

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VMHost

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

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

Tipo:Host
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Saídas

Host

Este cmdlet retorna um objeto Host.