共用方式為

Read-SCGuestInfo

  • 參考
模組:
VirtualMachineManager

擷取客體作業系統中與索引鍵相關聯的值。

Syntax

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

Description

Read-SCGuestInfo Cmdlet 會擷取客體作業系統中索引鍵/值) 組 (索引鍵/值組相關聯的值。

範例

範例 1：取得虛擬機器指定索引鍵的 IntegrationServicesVersion 值

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

第一個命令會取得名為 $VM 01 的虛擬機器物件，並將物件儲存在$VM變數中。

第二個命令會傳回虛擬機器 VM01 的 IntegrationServicesVersion 機碼/值組。

範例 2：使用管線運算子取得虛擬機器指定索引鍵的 IntegrationServicesVersion 值

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

此命令會傳回虛擬機器 VM01 的 IntegrationServicesVersion 機碼/值組。

範例 3：根據虛擬機器的指定金鑰取得多個 KVP 值

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

第一個命令會建立名為 $ValuesMap 的陣列。

第二和第三個命令會將值新增至$ValuesMap陣列。

第四個命令會取得名為 VM02 的虛擬機器物件，並將物件儲存在 $VM 變數中。

最後一個命令會傳回虛擬機器 VM02 的 IntegrationServicesVersion 和 NetworkAddressIPv4 索引鍵/值組。

範例 4：透過雜湊表讀取多個資料類型

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

第一個命令會取得名為 VM03 的虛擬機器物件，並將物件儲存在 $VM 變數中。

第二個命令會建立名為 $ValuesMap 的陣列。

第三個命令會將 NetworkAddressIPv4 新增至$ValuesMap陣列。

第四個命令會取得 VM03 的 NetworkAddressIPv4 索引鍵/值組。

第五個命令會將 NetworkAddressIPv6 新增至$ValuesMap陣列。

第六個命令會取得 VM03 的 NetworkAddressIPv6 索引鍵/值組。

第七個命令會建立名為 $ValuesMap 2 的陣列，其中包含 NetworkAddressIPv4 和 FullyQualifiedDomainName。

最後一個命令會傳回 NetworkAddressIPv4 和 VM03 的 FullyQualifiedDomainName 索引鍵/值組。

範例 5：讀取不存在的金鑰

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

第一個命令會取得名為 VM01 的虛擬機器物件，並將物件儲存在 $VM 變數中。

第二個、第四和第六個命令會建立一組 null 的索引鍵，並將集合儲存在$KeysDoNotExist變數中。

第三、第五和第七個命令會在 $KeysDoNotExist 中讀取 KVPMap，並顯示結果。

參數

-Key

指定索引鍵/值組中的索引鍵。

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

-KvpMap

指定對應至 Hyper-V 所公開值的索引鍵/值組雜湊表。

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

-VM

指定虛擬機器物件。

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

輸出

String

此 Cmdlet 會傳回 String 物件。