Summary
Sets the BIOS Power-On password on the current device unless specified for another platform
Syntax
Set-HPBIOSPowerOnPassword [-NewPassword] <String> [[-Password] <String>] [[-ComputerName] <String>] [<CommonParameters>]
Set-HPBIOSPowerOnPassword [-NewPassword] <String> [[-Password] <String>] [-CimSession] <CimSession> [<CommonParameters>]
Description
This command sets the BIOS Power-On password on the current device unless specified for another platform. The password must comply with password complexity requirements active on the system.
Parameters
| Name | Argument | Description |
|---|---|---|
| NewPassword | <String> | Specifies a new password for the BIOS Power-On password. To clear the password, use the Clear-HPBIOSPowerOnPassword command instead. |
| Password | <String> | Specifies the existing BIOS Setup password (not Power-On password), if any. If there is no BIOS Setup password set, this parameter may be omitted. Use the Get-HPBIOSSetupPasswordIsSet command to determine if a setup password is currently set. |
| ComputerName | <String> | Specifies a target computer for this command to create its own one-time-use CIMSession object using with. If not specified, this command will use the current device as the target computer for this command. The alias 'Target' can also be used for this parameter. |
| CimSession | <CimSession> | Specifies a pre-established CIMSession object (as created by the New-CIMSession command) or a ComputerName in string format for this command to create a one-time-use CIMSession object with |
Notes
- Requires HP BIOS.
- Use single quotes around the password to prevent PowerShell from interpreting special characters in the string.
- On many platform families, changing the Power-On password requires that a BIOS password is active.
- Changes in the state of the BIOS Power-On Password may not be visible until the system is rebooted and the POST prompt regarding the BIOS Power-On password is accepted.
Examples
PS C:\> Set-HPBIOSPowerOnPassword -NewPassword 'newpassword' -Password 'setuppassword'