Partilhar via

Read-SCGuestInfo

  • Referência
Módulo:
VirtualMachineManager

Recupera o valor associado a uma chave num sistema operativo de hóspedes.

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) num sistema operativo de hóspedes.

Exemplos

Exemplo 1: Obtenha 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 recebe o objeto da máquina virtual chamado $VM 01 e armazena o objeto na variável $VM.

O segundo comando devolve a chave/valor da IntegraçãoServicesversion para a máquina virtual VM01.

Exemplo 2: Obtenha o valor IntegrationServicesVersion para uma chave especificada para uma máquina virtual utilizando o operador do gasoduto

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

Este comando devolve a chave/par de valor IntegrationServicesVersion para a máquina virtual VM01.

Exemplo 3: Obtenha 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 recebe o objeto da máquina virtual chamado VM02 e armazena o objeto na variável $VM.

O último comando devolve os pares de chaves/valor IntegraçãoServicesVersion e NetworkAddressIPv4 para a máquina virtual VM02.

Exemplo 4: Ler vários tipos de dados através de um haxixe

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 recebe o objeto da 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 recebe o par de chaves/valor NetworkAddressIPv4 para VM03.

O quinto comando adiciona NetworkAddressIPv6 à matriz $ValuesMap.

O sexto comando recebe o par de chaves/valor NetworkAddressIPv6 para VM03.

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

O último comando devolve os pares chave/valor para NetworkAddressIPv4 e FullQualifiedDomainName 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 recebe o objeto da máquina virtual chamado VM01 e armazena o objeto na variável $VM.

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

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

Parâmetros

-Key

Especifica a chave num par chave/valor.

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

-KvpMap

Especifica uma tabela de haxixe de pares de chaves/valor correspondentes aos valores expostos por 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

Este cmdlet devolve um objeto de corda .