Set-VMFirmware

Set-VMFirmware

Sets the firmware configuration of a virtual machine.

Синтаксис

Parameter Set: VMName
Set-VMFirmware [-VMName] <String[]> [-BootOrder <VMComponentObject[]> ] [-ComputerName <String[]> ] [-EnableSecureBoot <OnOffState> ] [-FirstBootDevice <VMComponentObject> ] [-Passthru] [-PreferredNetworkBootProtocol <IPProtocolPreference> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: VMFirmware
Set-VMFirmware [-VMFirmware] <VMFirmware[]> [-BootOrder <VMComponentObject[]> ] [-EnableSecureBoot <OnOffState> ] [-FirstBootDevice <VMComponentObject> ] [-Passthru] [-PreferredNetworkBootProtocol <IPProtocolPreference> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: VMObject
Set-VMFirmware [-VM] <VirtualMachine[]> [-BootOrder <VMComponentObject[]> ] [-EnableSecureBoot <OnOffState> ] [-FirstBootDevice <VMComponentObject> ] [-Passthru] [-PreferredNetworkBootProtocol <IPProtocolPreference> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Подробное описание

The Set-VMFirmware cmdlet sets the firmware configuration of a Generation 2 virtual machine.

Параметры

-BootOrder<VMComponentObject[]>

Specifies an array of devices. The boot order determines the order of the devices from which to boot. Ниже указаны допустимые значения этого параметра.

  -- VMBootSource
  -- VMNetworkAdapter
  -- HardDiskDrive
  -- DVDDrive

The VMBootSource value describes a boot entry in firmware nonvolatile Random Access Memory (NVRAM).

Псевдонимы	отсутствуют
Требуется?	false
Указать положение?	named
Значение по умолчанию	отсутствуют
Принимать входные данные конвейера?	false
Принимать подстановочные знаки?	false

-ComputerName<String[]>

Specifies the names of the Hyper-V hosts whose firmware configuration you want to modify.

Псевдонимы	отсутствуют
Требуется?	false
Указать положение?	named
Значение по умолчанию	.
Принимать входные данные конвейера?	false
Принимать подстановочные знаки?	false

-EnableSecureBoot<OnOffState>

Specifies whether to enable secure boot. Ниже указаны допустимые значения этого параметра.

  -- On
  -- Off

Secure boot uses a public key infrastructure that protects the integrity of the operating system.

Псевдонимы	отсутствуют
Требуется?	false
Указать положение?	named
Значение по умолчанию	отсутствуют
Принимать входные данные конвейера?	false
Принимать подстановочные знаки?	false

-FirstBootDevice<VMComponentObject>

Specifies the device from which to attempt to boot from first. Ниже указаны допустимые значения этого параметра.

  -- VMBootSource
  -- VMNetworkAdapter
  -- HardDiskDrive
  -- DVDDrive

The VMBootSource value describes a boot entry in firmware NVRAM.

Псевдонимы	отсутствуют
Требуется?	false
Указать положение?	named
Значение по умолчанию	отсутствуют
Принимать входные данные конвейера?	false
Принимать подстановочные знаки?	false

-Passthru

Возвращает объект, представляющий элемент, с которым вы работаете. По умолчанию этот командлет не создает выходные данные.

Псевдонимы	отсутствуют
Требуется?	false
Указать положение?	named
Значение по умолчанию	отсутствуют
Принимать входные данные конвейера?	false
Принимать подстановочные знаки?	false

-PreferredNetworkBootProtocol<IPProtocolPreference>

Specifies the IP protocol version to use during a network boot.

Псевдонимы	отсутствуют
Требуется?	false
Указать положение?	named
Значение по умолчанию	отсутствуют
Принимать входные данные конвейера?	false
Принимать подстановочные знаки?	false

-VM<VirtualMachine[]>

Specifies the virtual machine objects for which want to modify the firmware configuration. To obtain a virtual machine object, use the Get-VM cmdlet.

Псевдонимы	отсутствуют
Требуется?	true
Указать положение?	1
Значение по умолчанию	отсутствуют
Принимать входные данные конвейера?	True (ByValue)
Принимать подстановочные знаки?	false

-VMFirmware<VMFirmware[]>

Specifies an array of virtual machine firmware configurations. The cmdlet sets the firmware configurations you specify.

Псевдонимы	отсутствуют
Требуется?	true
Указать положение?	1
Значение по умолчанию	отсутствуют
Принимать входные данные конвейера?	True (ByValue)
Принимать подстановочные знаки?	false

-VMName<String[]>

Specifies an array of names of virtual machines for which you want to modify the firmware configuration.

Псевдонимы	отсутствуют
Требуется?	true
Указать положение?	1
Значение по умолчанию	отсутствуют
Принимать входные данные конвейера?	True (ByValue)
Принимать подстановочные знаки?	false

-Confirm

Запрос на подтверждение перед выполнением командлета.

Требуется?	false
Указать положение?	named
Значение по умолчанию	false
Принимать входные данные конвейера?	false
Принимать подстановочные знаки?	false

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не запущен.

Требуется?	false
Указать положение?	named
Значение по умолчанию	false
Принимать входные данные конвейера?	false
Принимать подстановочные знаки?	false

<CommonParameters>

Этот командлет поддерживает следующие параметры: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, и -OutVariable. Для получения дополнительных сведений см. about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

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

Тип входных данных — это тип объектов, которые можно передать в командлет через конвейер.

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

Тип выходных данных — это тип объектов, которые выдает командлет.

• Microsoft.HyperV.Powershell.VMFirmware

Примечания

• Note: This cmdlet is supported only when run against Generation 2 virtual machines.

Примеры

Example 1

This example enables secure boot functionality on the virtual machine “Test VM”.

PS C:\> Set-VMFirmware "Test VM" -EnableSecureBoot On

Example 2

This example sets the virtual machine “Test VM” to boot off of the VM network adapter object stored in $vmNetworkAdapter. This object was acquired using get-VMNetworkAdapter.

PS C:\> Set-VMFirmware "Test VM" -FirstBootDevice $vmNetworkAdapter

Example 3

Sets the boot order for the virtual machine “Test VM”. $vmNetworkAdapter contains a VM Network Adapter object (acquired using get-VMNetworkAdapter) and $vmHardDiskDrive contains a VM hard disk object (acquired using get-VMHardDiskDrive). Any existing boot entries not specified by this command will be removed from the virtual machine.

PS C:\> Set-VMFirmware "Test VM" -BootOrder $vmNetworkAdapter, $vmHardDiskDrive

Связанные темы

Get-VMFirmware