Read-SCGuestInfo

Модуль:
VirtualMachineManager Module

Извлекает значение, связанное с ключом в гостевой операционной системе.

Синтаксис

MultipleKvpKeys (по умолчанию) 

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

SingleKvpKey 

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.

Вторая команда возвращает пару ключ/значение IntegrationServicesVersion для виртуальной машины VM01.

Пример 2: получение значения IntegrationServicesVersion для указанного ключа для виртуальной машины с помощью оператора конвейера

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

Эта команда возвращает пару ключ-значение IntegrationServicesVersion для виртуальной машины VM01.

Пример 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.

Последняя команда возвращает пары ключ-значение IntegrationServicesVersion и NetworkAddressIPv4 для виртуальной машины VM02.

Пример 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.

Четвертая команда получает пару ключ/значение NetworkAddressIPv4 для VM03.

Пятая команда добавляет NetworkAddressIPv6 в массив $ValuesMap.

Шестая команда получает пару ключ/значение NetworkAddressIPv6 для VM03.

Седьмая команда создает массив с именем $ValuesMap 2, который содержит NetworkAddressIPv4 и FullyQualifiedDomainName.

Последняя команда возвращает пары ключ-значение для NetworkAddressIPv4 и FullyQualifiedDomainName для VM03.

Пример 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.

Третья, пятая и седьмая команды считывают KVPMap в $KeysDoNotExist и отображают результаты.

Параметры

-Key

Указывает ключ в паре ключ-значение.

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

SingleKvpKey
Position:1
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-KvpMap

Указывает хэш-таблицу пар ключ-значение, соответствующих значениям, предоставляемым Hyper-V.

Свойства параметра

Тип:Hashtable
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

MultipleKvpKeys
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-VM

Указывает объект виртуальной машины.

Свойства параметра

Тип:VM
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:0
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Выходные данные

String

Этот командлет возвращает объект String .