次の方法で共有

Read-SCGuestInfo

  • リファレンス
モジュール:
VirtualMachineManager

ゲスト オペレーティング システムのキーに関連付けられている値を取得します。

構文

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

説明

Read-SCGuestInfo コマンドレットは、ゲスト オペレーティング システムのキー (キーと値のペア) に関連付けられている値を取得します。

例

例 1: 仮想マシンの指定したキーの IntegrationServicesVersion 値を取得する

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

最初のコマンドは、$VM 01 という名前の仮想マシン オブジェクトを取得し、そのオブジェクトを $VM 変数に格納します。

2 番目のコマンドは、仮想マシン 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という名前の配列を作成します。

2 番目と 3 番目のコマンドは、$ValuesMap配列に値を追加します。

4 番目のコマンドは、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 変数に格納します。

2 番目のコマンドは、$ValuesMapという名前の配列を作成します。

3 番目のコマンドは、$ValuesMap配列に NetworkAddressIPv4 を追加します。

4 番目のコマンドは、VM03 の NetworkAddressIPv4 キーと値のペアを取得します。

5 番目のコマンドは、networkAddressIPv6 を $ValuesMap 配列に追加します。

6 番目のコマンドは、VM03 の NetworkAddressIPv6 キーと値のペアを取得します。

7 番目のコマンドは、NetworkAddressIPv4 と完全修飾ドメイン名を含む $ValuesMap 2 という名前の配列を作成します。

最後のコマンドは、NetworkAddressIPv4 のキーと値のペアと VM03 の完全修飾DomainName を返します。

例 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 変数に格納します。

2 番目、4 番目、6 番目の各コマンドは、それぞれ null キーのセットを作成し、そのセットを $KeysDoNotExist 変数に格納します。

3 番目、5 番目、7 番目のコマンドは、$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

このコマンドレットは 、String オブジェクトを返します。