Sdílet prostřednictvím

Read-SCGuestInfo

  • Reference
Modul:
VirtualMachineManager

Načte hodnotu přidruženou ke klíči v hostovaném operačním systému.

Syntaxe

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

Description

Rutina Read-SCGuestInfo načte hodnotu přidruženou ke klíči (páru klíč/hodnota) v hostovaném operačním systému.

Příklady

Příklad 1: Získání hodnoty IntegrationServicesVersion pro zadaný klíč pro virtuální počítač

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

První příkaz získá objekt virtuálního počítače s názvem $VM 01 a uloží objekt do proměnné $VM.

Druhý příkaz vrátí dvojici klíč/hodnota IntegrationServicesVersion pro virtuální počítač VM01.

Příklad 2: Získání hodnoty IntegrationServicesVersion pro zadaný klíč pro virtuální počítač pomocí operátoru kanálu

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

Tento příkaz vrátí dvojici klíč/hodnota IntegrationServicesVersion pro virtuální počítač VM01.

Příklad 3: Získání více hodnot KVP na základě zadaných klíčů pro virtuální počítač

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

První příkaz vytvoří pole s názvem $ValuesMap.

Druhý a třetí příkaz přidá hodnoty do pole $ValuesMap.

Čtvrtý příkaz získá objekt virtuálního počítače s názvem VM02 a uloží ho do proměnné $VM.

Poslední příkaz vrátí páry klíč/hodnota Pro virtuální počítač VM02 IntegrationServicesVersion a NetworkAddressIPv4.

Příklad 4: Čtení více datových typů prostřednictvím 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

První příkaz získá objekt virtuálního počítače s názvem VM03 a uloží ho do proměnné $VM.

Druhý příkaz vytvoří pole s názvem $ValuesMap.

Třetí příkaz přidá NetworkAddressIPv4 do pole $ValuesMap.

Čtvrtý příkaz získá dvojici klíč/hodnota NetworkAddressIPv4 pro VM03.

Pátý příkaz přidá NetworkAddressIPv6 do pole $ValuesMap.

Šestý příkaz získá dvojici klíč/hodnota NetworkAddressIPv6 pro VM03.

Sedmý příkaz vytvoří pole s názvem $ValuesMap 2, které obsahuje NetworkAddressIPv4 a FullyQualifiedDomainName.

Poslední příkaz vrátí páry klíč/hodnota pro NetworkAddressIPv4 a FullyQualifiedDomainName pro VM03.

Příklad 5: Čtení klíčů, které neexistují

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

První příkaz získá objekt virtuálního počítače s názvem VM01 a uloží ho do proměnné $VM.

Druhý, čtvrtý a šestý příkaz každý vytvoří sadu klíčů, které mají hodnotu null a uloží sadu do proměnné $KeysDoNotExist.

Třetí, pátý a sedmý příkaz načtou KVPMap v $KeysDoNotExist a zobrazí výsledky.

Parametry

-Key

Určuje klíč v páru klíč/hodnota.

Typ:String
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-KvpMap

Určuje tabulku hash párů klíč/hodnota odpovídající hodnotám vystaveným technologií Hyper-V.

Typ:Hashtable
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-VM

Určuje objekt virtuálního počítače.

Typ:VM
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Výstupy

String

Tato rutina vrátí objekt String.