Set-CMPowerControl

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

Syntax

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

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
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DeviceName

Specifies an array of device names.

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

Specifies a CMPowerControl object.

Type:IResultObject
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
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
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

DisableWildcardHandling treats wildcard characters as literal character values. Cannot be combined with ForceWildcardHandling.

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

ForceWildcardHandling processes wildcard characters and may lead to unexpected behavior (not recommended). Cannot be combined with DisableWildcardHandling.

Type:SwitchParameter
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
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False