Compartir a través de

Read-SCGuestInfo

  • Referencia
Módulo:
VirtualMachineManager

Recupera el valor asociado a una clave en un sistema operativo invitado.

Sintaxis

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

Description

El cmdlet Read-SCGuestInfo recupera el valor asociado a una clave (par clave-valor) en un sistema operativo invitado.

Ejemplos

Ejemplo 1: Obtención del valor IntegrationServicesVersion de una clave especificada para una máquina virtual

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

El primer comando obtiene el objeto de máquina virtual denominado $VM 01 y almacena el objeto en la variable $VM.

El segundo comando devuelve el par clave-valor IntegrationServicesVersion para la máquina virtual VM01.

Ejemplo 2: Obtención del valor IntegrationServicesVersion de una clave especificada para una máquina virtual mediante el operador de canalización

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

Este comando devuelve el par clave-valor IntegrationServicesVersion para la máquina virtual VM01.

Ejemplo 3: Obtención de varios valores KVP en función de las claves especificadas para una 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

El primer comando crea una matriz denominada $ValuesMap.

Los comandos segundo y tercero agregan valores a la matriz $ValuesMap.

El cuarto comando obtiene el objeto de máquina virtual denominado VM02 y almacena el objeto en la variable $VM.

El último comando devuelve los pares de clave y valor IntegrationServicesVersion y NetworkAddressIPv4 para la máquina virtual VM02.

Ejemplo 4: Leer varios tipos de datos mediante una tabla hash

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

El primer comando obtiene el objeto de máquina virtual denominado VM03 y almacena el objeto en la variable $VM.

El segundo comando crea una matriz denominada $ValuesMap.

El tercer comando agrega NetworkAddressIPv4 a la matriz $ValuesMap.

El cuarto comando obtiene el par clave-valor NetworkAddressIPv4 para VM03.

El quinto comando agrega NetworkAddressIPv6 a la matriz $ValuesMap.

El sexto comando obtiene el par clave-valor NetworkAddressIPv6 para VM03.

El séptimo comando crea una matriz denominada $ValuesMap 2 que contiene NetworkAddressIPv4 y FullyQualifiedDomainName.

El último comando devuelve los pares clave-valor de NetworkAddressIPv4 y FullyQualifiedDomainName para VM03.

Ejemplo 5: Lectura de claves que no existen

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

El primer comando obtiene el objeto de máquina virtual denominado VM01 y almacena el objeto en la variable $VM.

Los comandos segundo, cuarto y sexto crean cada uno un conjunto de claves que son NULL y almacena el conjunto en la variable $KeysDoNotExist.

Los comandos tercero, quinto y séptimo leen KVPMap en $KeysDoNotExist y muestran los resultados.

Parámetros

-Key

Especifica la clave en un par clave-valor.

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-KvpMap

Especifica una tabla hash de pares clave-valor correspondientes a los valores expuestos por Hyper-V.

Tipo:Hashtable
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-VM

Especifica un objeto de máquina virtual.

Tipo:VM
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Salidas

String

Este cmdlet devuelve un objeto string .