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

As propriedades do host que este cmdlet atualiza incluem:

  • Nome
  • 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 progresso do trabalho é acompanhado e armazenado na variável nomeada por esse parâmetro.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PROTipID

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

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 das do atualizador em banda.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunAsynchronously

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VMHost

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

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

Tipo:Host
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Saídas

Host

Esse cmdlet retorna um objeto Host.