This is the built-in help made by Microsoft for the command 'Stop-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.
Shuts down a remote hardware device.
Stop-PcsvDevice [-AsJob] [-CimSession <CimSession>] [-PassThru] [-ThrottleLimit <Int32>] -InputObject <CimInstance> [-Confirm] [-WhatIf] [<CommonParameters>]
Stop-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>]
The Stop-PcsvDevice cmdlet shuts down 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 Disabled state, which corresponds to a hard shutdown of the hardware device. Specify the remote hardware device by the management name or IP
address, provide credentials necessary to shut down the remote hardware device, and specify which management protocol to use. The credentials must have administrator
permissions on the remote hardware device.
Online Version: http://go.microsoft.com/fwlink/?LinkID=288919
Example 1: Shut down a computer
PS C:\> $Credential = Get-Credential
PS C:\>Stop-PcsvDevice -TargetAddress "10.1.12.43" -Credential $Credential -ManagementProtocol IPMI
This example shuts down a computer.
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 shuts down the 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, needed to connect to the computer. By default, the cmdlet prompts you before it stops the remote hardware device.