Поделиться через

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.

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

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

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

Эта команда возвращает пару key/value 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
Position:1
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-KvpMap

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

Тип:Hashtable
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-VM

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

Тип:VM
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

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

String

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