Read-SCGuestInfo

  • Referência
Módulo:
VirtualMachineManager

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

Syntax

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 de 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

Esse comando retorna o par chave/valor IntegrationServicesVersion para vm01 de máquina virtual.

Exemplo 3: obter vários valores de 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 o 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 VM02 de máquina virtual.

Exemplo 4: Ler vários tipos de dados por meio de um 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: Chaves de leitura 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, o quarto e o sexto comandos criam cada um um conjunto de chaves que são nulas e armazena o conjunto na variável $KeysDoNotExist.

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

Parâmetros

-Key

Especifica a chave em um par chave/valor.

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

-KvpMap

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

Type:Hashtable
Position:Named
Default value:None
Required:True
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

Saídas

String

Esse cmdlet retorna um objeto String .