PowerShell Logo Small

Start-PcsvDevice



This is the built-in help made by Microsoft for the command 'Start-PcsvDevice', 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

Starts the specified remote hardware device.

SYNTAX


Start-PcsvDevice [-AsJob] [-CimSession <CimSession[]>] [-PassThru] [-ThrottleLimit <Int32>] -InputObject <CimInstance[]> [-Confirm] [-WhatIf] [<CommonParameters>]
Start-PcsvDevice [-TargetAddress] <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 Start-PcsvDevice cmdlet starts a remote hardware device by using Web Services for Management (WS-Management) or Intelligent Platform Management Interface (IPMI). The
cmdlet puts the device in the Enabled state, which corresponds to a startup of the hardware device. Specify the remote hardware device by the management name or IP address,
provide credentials necessary to start the remote hardware device, and specify which management protocol to use. The credentials must have administrator permissions on the
remote hardware device. You can also specify an authentication type to use for WS-Management.



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkID=288918
Get-PcsvDevice
Restart-PcsvDevice
Set-PcsvDeviceBootConfiguration
Stop-PcsvDevice

REMARKS

<

Examples


Example 1: Start a computer by specifying its IP address

PS C:\> $Credential = Get-Credential
PS C:\> Start-PcsvDevice -TargetAddress "10.1.12.43" -Credential $Credential -ManagementProtocol IPMI



This example starts a device. After you execute these commands, the device enters the Enabled state.

The first command uses the Get-Credential cmdlet to create a credential, and then stores it in the $Credential variable. The cmdlet prompts you for a user name and password.
For more information, type Get-Help Get-Credential.

The second command starts the target computer that has the management IP address 10.1.12.43 by using the IPMI management protocol. The command specifies the credential
object stored in the $Credential variable.




Example 2: Start a computer by specifying it as an object

PS C:\> $Credential = Get-Credential
PS C:\> Get-PcsvDevice –TargetAddress "10.1.12.43" -Credential $Credential -ManagementProtocol IPMI | Start-PcsvDevice



This example starts a device specified as an object. After you execute these commands, the device enters the Enabled state.

The first command uses the Get-Credential cmdlet to create a credential, and then stores it in the $Credential variable. 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 connect to the computer that has the specified management IP address by using the IPMI management protocol. The command
specifies the credential object stored in the $Credential variable. The cmdlet passes that connection to the Start-PcsvDevice cmdlet by using the pipeline operator. That
cmdlet starts the device.