PowerShell Logo Small

Set-PcsvDeviceBootConfiguration



This is the built-in help made by Microsoft for the command 'Set-PcsvDeviceBootConfiguration', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Modifies the boot configuration on the remote hardware device.

SYNTAX


Set-PcsvDeviceBootConfiguration [-OneTimeBootSource] <String> [-AsJob] [-CimSession <CimSession[]>] [-PassThru] [-ThrottleLimit <Int32>] -InputObject <CimInstance[]>
[-Confirm] [-WhatIf] [<CommonParameters>]
Set-PcsvDeviceBootConfiguration [-TargetAddress] <String> [-OneTimeBootSource] <String> [-Credential] <PSCredential> [-ManagementProtocol] <ManagementProtocol> [[-Port]
<UInt16>] [-AsJob] [-Authentication <Authentication>] [-CimSession <CimSession[]>] [-PassThru] [-SkipCACheck] [-SkipCNCheck] [-SkipRevocationCheck] [-ThrottleLimit <Int32>]
[-TimeoutSec <UInt32>] [-UseSSL] [-Confirm] [-WhatIf] [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Set-PcsvDeviceBootConfiguration cmdlet modifies the boot configuration for a remote hardware device. To retrieve the current boot configuration for a device, use the
Get-PcsvDevice cmdlet.


The StructuredBootString property of the returned instance lists the valid boot sources, and the OneTimeBootSource property indicates whether one of the valid boot sources
has already been configured to be the primary boot source for the next time the device undergoes a full restart.



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkID=288917
Get-PcsvDevice

REMARKS

<

Examples


Example 1 Modify the device boot configuration to use PXE boot

PS C:\> $MyCred = Get-Credential
PS C:\> Set-PCSVDeviceBootConfiguration -TargetAdress 10.1.12.43 -ManagementProtocol WSMan -Credential $MyCred -UseSSL -OneTimeBootSource "CIM:Network:1"



This example configures the boot source to use Pre-Boot Execution Environment (PXE) boot the next time the system boots.

The first command uses the Get-Credential cmdlet to get credentials, and stores the credentials in the variable named $MyCred. The cmdlet prompts you for a user name and
password. For more information, type Get-Help Get-Credential.

The second command modifies the device boot configuration for the target computer, by using the OneTimeBootSource parameter to specify the boot configuration.




Example 2: Modify the device boot configuration to use the DVD drive

PS C:\> $MyCred = Get-Credential
PS C:\> Get-PCSVDevice -TargetAddress 10.1.12.43 -ManagementProtocol WSMan -Credential $MyCred -UseSSL | Set-PcsvDeviceBootConfiguration -OneTimeBootSource "CIM:CD/DVD:1"



This example configures the boot source to use the DVD drive for the next time the system boots.

The first command uses the Get-Credential cmdlet to get credentials, and stores the credentials in the variable named $MyCred. The cmdlet prompts you for a user name and
password. For more information, type Get-Help Get-Credential.

The second command uses the Get-PcsvDevice cmdlet to retrieve the configuration for the target computer, and passes the output to the Set-PcsvDeviceBootConfiguration cmdlet
by using the pipeline operator.