Set-CMPowerControl

Changes power state for client devices by using AMT power control commands.

Syntax

Set-CMPowerControl
   [-Confirm]
   -DeviceId <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   -PowerControl <PowerControlType>
   [-WhatIf]
   [<CommonParameters>]
Set-CMPowerControl [-Confirm] -DeviceName  [-DisableWildcardHandling] [-ForceWildcardHandling]
 -PowerControl  [-WhatIf] []
Set-CMPowerControl [-Confirm] [-DisableWildcardHandling] [-ForceWildcardHandling] -InputObject 
 -PowerControl  [-WhatIf] []

Description

The Set-CMPowerControl cmdlet changes the power state for one or more Intel Active Management Technology (Intel AMT) provisioned client devices in Microsoft System Center Configuration Manager by using AMT power control commands.

Examples

Example 1: Change the power control setting for a client device

PS C:\> Set-CMPowerControl -DeviceId "209224563" -PowerControl Restart

This command changes the power control setting to Restart for the client device that has the ID 209224563.

Required Parameters

-DeviceId

Specifies an array of device IDs.

Type:String
Aliases:ResourceId
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DeviceName

Specifies an array of device names.

Type:String
Aliases:Name
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InputObject

Specifies a CMPowerControl object.

Type:IResultObject
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-PowerControl

Specifies the power management action. The acceptable values for this parameter are:- None. Disables power settings.

  • WakeUp. Turns on a sleeping computer.
  • Restart. Performs a hard reset of the computer and turns on the computer. This action does not shut the operating system down.
  • Shutdown. Performs a hard reset of the computer. This action does not shut the operating system down.
Type:PowerControlType
Parameter Sets:Wakeup, Restart, Shutdown
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

Indicates that wildcard handling is disabled.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

Indicates that wildcard handling is enabled.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False