PowerShell Logo Small

Restart-PcsvDevice



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

Restarts a remote hardware device.

SYNTAX


Restart-PcsvDevice [-AsJob] [-CimSession <CimSession[]>] [-PassThru] [-ThrottleLimit <Int32>] -InputObject <CimInstance[]> [-Confirm] [-WhatIf] [<CommonParameters>]
Restart-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 Restart-PcsvDevice cmdlet restarts a device remotely by using Web Services for Management (WS-Management) or Intelligent Platform Management Interface (IPMI). The cmdlet
restarts the device if the current state of the device is enabled, or starts the device if the current state is other than enabled. If you specify a device that is a
Baseboard Management Controller (BMC), the cmdlet restarts the system that the BMC manages, and not the BMC.



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkId=288916
Get-PcsvDevice
Start-PcsvDevice
Stop-PcsvDevice

REMARKS

<

Examples


Example 1: Restart a remote IPMI hardware device

PS C:\> $Credential = Get-Credential Admin
PS C:\> Restart-PCSVDevice -TargetAddress 10.0.0.29 -ManagementProtocol IPMI -Credential $Credential
Confirm
Are you sure you want to perform this action?
Performing operation 'Changing state of machine' on Target '10.10.0.29'.
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y



This example restarts an IPMI device remotely.

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 connects with the target computer that has the IP address 10.0.0.29 by using the IPMI management protocol The command specifies the credential object
stored in the $Credential variable. The command prompts the user for confirmation because restarting the system can cause a loss of unsaved state.




Example 2: Restart an IPMI device remotely by using an object variable

PS C:\> $Credential = Get-Credential Admin
PS C:\> Get-PcsvDevice -TargetAddress 10.0.0.29 -ManagementProtocol IPMI -Credential $Credential | Restart-PcsvDevice -Confirm $False



This example restarts an IPMI device remotely by using an object variable to specify the device.

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 with the target computer that has the IP address 10.0.0.29 by using the IPMI management protocol and the
credential object stored in the $Credential variable. The command gets the remote device object and passes the object to the Restart-PcsvDevice cmdlet by using the pipeline
operator. The Restart-PcsvDevice cmdlet restarts the remote device. The command sets the Confirm parameter to $False so the cmdlet does not prompt the user for confirmation
to restart the device.