Dela via

Read-SCGuestInfo

  • Referens
Modul:
VirtualMachineManager

Hämtar värdet som är associerat med en nyckel i ett gästoperativsystem.

Syntax

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

Description

Cmdleten Read-SCGuestInfo hämtar värdet som är associerat med en nyckel (nyckel/värde-par) i ett gästoperativsystem.

Exempel

Exempel 1: Hämta värdet IntegrationServicesVersion för en angiven nyckel för en virtuell dator

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

Det första kommandot hämtar det virtuella datorobjektet med namnet $VM 01 och lagrar objektet i variabeln $VM.

Det andra kommandot returnerar nyckel/värde-paret IntegrationServicesVersion för den virtuella datorn VM01.

Exempel 2: Hämta värdet IntegrationServicesVersion för en angiven nyckel för en virtuell dator med hjälp av pipelineoperatorn

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

Det här kommandot returnerar nyckel/värde-paret IntegrationServicesVersion för den virtuella datorn VM01.

Exempel 3: Hämta flera KVP-värden baserat på angivna nycklar för en virtuell dator

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

Det första kommandot skapar en matris med namnet $ValuesMap.

De andra och tredje kommandona lägger till värden i $ValuesMap-matrisen.

Det fjärde kommandot hämtar det virtuella datorobjektet med namnet VM02 och lagrar objektet i variabeln $VM.

Det sista kommandot returnerar nyckel/värde-paren IntegrationServicesVersion och NetworkAddressIPv4 för den virtuella datorn VM02.

Exempel 4: Läsa flera datatyper via en hash-tabell

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

Det första kommandot hämtar det virtuella datorobjektet med namnet VM03 och lagrar objektet i variabeln $VM.

Det andra kommandot skapar en matris med namnet $ValuesMap.

Det tredje kommandot lägger till NetworkAddressIPv4 i matrisen $ValuesMap.

Det fjärde kommandot hämtar nyckel/värde-paret NetworkAddressIPv4 för VM03.

Det femte kommandot lägger till NetworkAddressIPv6 i matrisen $ValuesMap.

Det sjätte kommandot hämtar nyckel/värde-paret NetworkAddressIPv6 för VM03.

Det sjunde kommandot skapar en matris med namnet $ValuesMap 2 som innehåller NetworkAddressIPv4 och FullyQualifiedDomainName.

Det sista kommandot returnerar nyckel/värde-paren för NetworkAddressIPv4 och FullyQualifiedDomainName för VM03.

Exempel 5: Läsnycklar som inte finns

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

Det första kommandot hämtar det virtuella datorobjektet med namnet VM01 och lagrar objektet i variabeln $VM.

De andra, fjärde och sjätte kommandona skapar varsin uppsättning nycklar som är null och lagrar uppsättningen i variabeln $KeysDoNotExist.

De tredje, femte och sjunde kommandona läser KVPMap i $KeysDoNotExist och visar resultatet.

Parametrar

-Key

Anger nyckeln i ett nyckel/värde-par.

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

-KvpMap

Anger en hash-tabell med nyckel/värde-par som motsvarar de värden som exponeras av Hyper-V.

Type:Hashtable
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VM

Anger ett virtuellt datorobjekt.

Type:VM
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Utdata

String

Den här cmdleten returnerar ett String-objekt .