Set-VMBios
Set-VMBios
Configures the BIOS of a virtual machine.
Syntax
Parameter Set: VMName
Set-VMBios [-VMName] <String[]> [-ComputerName <String[]> ] [-DisableNumLock] [-EnableNumLock] [-Passthru] [-StartupOrder <BootDevice[]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: VMBios
Set-VMBios [-VMBios] <VMBios[]> [-DisableNumLock] [-EnableNumLock] [-Passthru] [-StartupOrder <BootDevice[]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: VMObject
Set-VMBios [-VM] <VirtualMachine[]> [-DisableNumLock] [-EnableNumLock] [-Passthru] [-StartupOrder <BootDevice[]> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Set-VMBios cmdlet configures the BIOS of a virtual machine.
Parameters
-ComputerName<String[]>
Specifies one or more Hyper-V hosts for which the BIOS is to be configured. NetBIOS names, IP addresses, and fully-qualified domain names are allowable. The default is the local computer — use “localhost” or a dot (“.”) to specify the local computer explicitly.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
. |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-DisableNumLock
Specifies that NumLock is to be disabled in the BIOS of the virtual machine to be configured.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-EnableNumLock
Specifies that NumLock is to be enabled in the BIOS of the virtual machine to be configured.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Passthru
Specifies that an Microsoft.Virtualization.Powershell.Bios object is to be passed through to the pipeline representing the BIOS to be configured.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-StartupOrder<BootDevice[]>
Specifies an array of boot devices representing the boot order in the BIOS of the virtual machine. The boot devices are specified as members of the BootDevices enumeration (CD, IDE, LegacyNetworkAdapter, Floppy).
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-VM<VirtualMachine[]>
Specifies the virtual machine for which the BIOS is to be configured.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-VMBios<VMBios[]>
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-VMName<String[]>
Specifies the name of the virtual machine for which the BIOS is to be configured.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
true |
-Confirm
Prompts you for confirmation before running the cmdlet.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
- None by default; Microsoft.Virtualization.Powershell.Bios if –PassThru is specified.
Examples
Example 1
This example disables the NumLock key by default on virtual machine TestVM.
PS C:\> Set-VMBios TestVM -DisableNumLock
Example 2
This example configures virtual machine TestVM to check for a boot device in the following order: floppy disk, network, CD drive, hard disk.
PS C:\> Set-VMBios TestVM -StartupOrder @("Floppy", "LegacyNetworkAdapter", "CD", "IDE”)