Partilhar via

Read-SCGuestInfo

  • Referência
Módulo:
VirtualMachineManager

Recupera o valor associado a uma chave em um sistema operacional convidado.

Sintaxe

Read-SCGuestInfo
    [-VM] <VM>
    -KvpMap <Hashtable>
    [<CommonParameters>]
Read-SCGuestInfo
    [-VM] <VM>
    [-Key] <String>
    [<CommonParameters>]

Description

O cmdlet Read-SCGuestInfo recupera o valor associado a uma chave (par chave/valor) em um sistema operacional convidado.

Exemplos

Exemplo 1: Obter o valor IntegrationServicesVersion para uma chave especificada para uma máquina virtual

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

O primeiro comando obtém o objeto de máquina virtual chamado $VM 01 e armazena o objeto na variável $VM.

O segundo comando retorna o par chave/valor IntegrationServicesVersion para VM01 da máquina virtual.

Exemplo 2: Obter o valor IntegrationServicesVersion para uma chave especificada para uma máquina virtual usando o operador de pipeline

PS C:\> Get-SCVirtualMachine -Name "VM01" | Read-SCGuestInfo -Key IntegrationServicesVersion

Este comando retorna o par chave/valor IntegrationServicesVersion para a máquina virtual VM01.

Exemplo 3: Obter vários valores KVP com base em chaves especificadas para uma máquina virtual

PS C:\> $ValuesMap = @{}
PS C:\> $ValuesMap.Add("NetworkAddressIPv4", $Null)
PS C:\> $ValuesMap.Add("IntegrationServicesVersion", $Null)
PS C:\> $VM = Get-SCVirtualMachine "VM02" 
PS C:\> Read-SCGuestInfo -VM $VM -KvpMap $ValuesMap

O primeiro comando cria uma matriz chamada $ValuesMap.

O segundo e terceiro comandos adicionam valores à matriz $ValuesMap.

O quarto comando obtém o objeto de máquina virtual chamado VM02 e armazena o objeto na variável $VM.

O último comando retorna os pares chave/valor IntegrationServicesVersion e NetworkAddressIPv4 para a máquina virtual VM02.

Exemplo 4: Ler vários tipos de dados através de uma hashtable

PS C:\> $VM = Get-SCVirtualMachine -Name "VM03"
PS C:\> $ValuesMap = @{}
PS C:\> $ValuesMap.Add("NetworkAddressIPv4", $Null)
PS C:\> Read-SCGuestInfo -VM $VM -KvpMap $ValuesMap
PS C:\> $ValuesMap.Add("NetworkAddressIPv6", $Null)
PS C:\> Read-SCGuestInfo -VM $VM -KvpMap $ValuesMap
PS C:\> $ValuesMap2 = @{"NetworkAddressIPv4" = $Null; "FullyQualifiedDomainName" = $Null}
PS C:\> Read-SCGuestInfo -VM $VM -KvpMap $ValuesMap2

O primeiro comando obtém o objeto de máquina virtual chamado VM03 e armazena o objeto na variável $VM.

O segundo comando cria uma matriz chamada $ValuesMap.

O terceiro comando adiciona NetworkAddressIPv4 à matriz $ValuesMap.

O quarto comando obtém o par chave/valor NetworkAddressIPv4 para VM03.

O quinto comando adiciona NetworkAddressIPv6 à matriz $ValuesMap.

O sexto comando obtém o par chave/valor NetworkAddressIPv6 para VM03.

O sétimo comando cria uma matriz chamada $ValuesMap 2 que contém NetworkAddressIPv4 e FullyQualifiedDomainName.

O último comando retorna os pares chave/valor para NetworkAddressIPv4 e FullyQualifiedDomainName para VM03.

Exemplo 5: Ler chaves que não existem

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $KeysDoNotExist = @{"o1ff1" = $Null; "o1ff2" = $Null; "o1ff3" = $Null ; "o1ff4" = $Null }
PS C:\> Read-SCGuestInfo -VM $VM -KVPMap $KeysDoNotExist 
PS C:\> $KeysDoNotExist = @{"off4" = $Null; "o1ff2" = $Null; "o1ff3" = $Null ; "o1ff4" = $Null }
PS C:\> Read-SCGuestInfo -VM $VM -KVPMap $KeysDoNotExist 
PS C:\> $KeysDoNotExist = @{"o1ff1" = $Null; "o1ff2" = $Null; "off4" = $Null ; "o1ff4" = $Null }
PS C:\> Read-SCGuestInfo -VM $VM -KVPMap $KeysDoNotExist

O primeiro comando obtém o objeto de máquina virtual chamado VM01 e armazena o objeto na variável $VM.

O segundo, quarto e sexto comandos criam um conjunto de chaves que são nulas e armazenam o conjunto na variável $KeysDoNotExist.

O terceiro, quinto e sétimo comandos leem o KVPMap em $KeysDoNotExist e exibem os resultados.

Parâmetros

-Key

Especifica a chave em um par chave/valor.

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

-KvpMap

Especifica uma tabela de hash de pares chave/valor correspondentes aos valores expostos pelo Hyper-V.

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

-VM

Especifica um objeto de máquina virtual.

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

Saídas

String

Este cmdlet retorna um objeto String.