PowerShell Logo Small

Stop-PcsvDevice



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.

SYNOPSIS

Shuts down a remote hardware device.

SYNTAX


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>]



Search powershellhelp.space

DESCRIPTION


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.



<

RELATED LINKS

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

REMARKS

<

Examples


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.