Start SCCM Client Action PowerShell Tool Help File

The help information provided below can also be viewed by using the following syntax:

Get-Help Start-CMClientAction –Full

Help Info

NAME

Start-CMClientAction

SYNOPSIS

The "Start-CMClientAction" function initiates allows 49 different SCCM client actions to be initiated on
one, or more computers.

SYNTAX

Start-CMClientAction [-ComputerName <Object>] -SCCMClientAction <Int32>

[<CommonParameters>]

Start-CMClientAction [-ComputerName <Object>] [-SCCMActionsBundle] [<CommonParameters>]

DESCRIPTION

The "Start-CMClientAction" PowerShell function allows for the initiaion of 49 SCCM client actions that
can be ran on the

local computer, or remote computers. Only one client action can be ran at a time, so using an array to
include several

client actions is not allowed. The Configuration Manager applet in Control Panel on the Actions tab
lists 10 actions and

these are identified in the Notes section with a "ConfigMgr Control Panel Applet" in parenthesis.
SCCM Administrators

typically find themselves running the following 3 actions during their monthly software update
deployments (patching):
 Machine Policy Retrieval & Evaluation Cycle, Software Updates Scan Cycle, and Software Updates
Deployment Evaluation

Cycle. Because these 3 actions are so common, I decided to offer a way to bundle them with a 5
minute wait time (300

seconds) between each action. The parameter to use to run these 3 bundled actions is the '-
SCCMActionsBundle' parameter.

The 'SCCMClientAction' and the 'SCCMActionsBundle' parameters are members of different

parameter sets, so they cannot be

used together.

PARAMETERS

-ComputerName <Object>

Enter the name of one or more computers that you wish to initiate an SCCM client action on.

Required? false

Position? named

Default value $env:COMPUTERNAME

Accept pipeline input? true (ByValue, ByPropertyName)

Accept wildcard characters? false

-SCCMClientAction <Int32>

Enter a numerical value from 1-49 that represents each SCCM client action listed in the Notes
section under ther "SCCM

Client Action Trigger Codes" heading.

Required? true

Position? named

Default value 0

Accept pipeline input? false

 Accept wildcard characters? false

-SCCMActionsBundle [<SwitchParameter>]

A switch parameter that does not accept any values, but rather tells the function to run the
following 3 actions

listed in the Notes section under ther "SCCM Client Action Trigger Codes" heading:

* Option 7 - Request Machine Assignments - (ConfigMgr Control Panel Applet - Machine Policy
Retrieval & Evaluation

Cycle)

* Option 38 - Scan by Update Source - (ConfigMgr Control Panel Applet - Software Updates Scan
Cycle)

* Option 33 - Software Updates Assignments Evaluation Cycle - (ConfigMgr Control Panel Applet -
Software Updates

Deployment Evaluation Cycle)

Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false

<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).

INPUTS
OUTPUTS

NOTES

SCCM Client Action Trigger Codes

--------------------------------

1 - {00000000-0000-0000-0000-000000000001} Hardware Inventory - (ConfigMgr Control Panel

Applet - Hardware Inventory

Cycle)

2 - {00000000-0000-0000-0000-000000000002} Software Inventory - (ConfigMgr Control Panel

Applet - Software Inventory

Cycle)

3 - {00000000-0000-0000-0000-000000000003} Discovery Inventory - (ConfigMgr Control Panel

Applet - Discovery Data

Collection Cycle)

4 - {00000000-0000-0000-0000-000000000010} File Collection - (ConfigMgr Control Panel Applet -

File Collection Cycle)

5 - {00000000-0000-0000-0000-000000000011} IDMIF Collection

6 - {00000000-0000-0000-0000-000000000012} Client Machine Authentication

7 - {00000000-0000-0000-0000-000000000021} Request Machine Assignments - (ConfigMgr Control

Panel Applet - Machine

Policy Retrieval & Evaluation Cycle)

8 - {00000000-0000-0000-0000-000000000022} Evaluate Machine Policies

9 - {00000000-0000-0000-0000-000000000023} Refresh Default MP Task

10 - {00000000-0000-0000-0000-000000000024} LS (Location Service) Refresh Locations Task

11 - {00000000-0000-0000-0000-000000000025} LS (Location Service) Timeout Refresh Task

12 - {00000000-0000-0000-0000-000000000026} Policy Agent Request Assignment (User)

13 - {00000000-0000-0000-0000-000000000027} Policy Agent Evaluate Assignment (User) -

(ConfigMgr Control Panel Applet
 - User Policy Retrieval & Evaluation Cycle)

14 - {00000000-0000-0000-0000-000000000031} Software Metering Generating Usage Report

15 - {00000000-0000-0000-0000-000000000032} Source Update Message - (ConfigMgr Control

Panel Applet - Windows

Installer Source List Update Cycle)

16 - {00000000-0000-0000-0000-000000000037} Clearing Proxy Settings Cache

17 - {00000000-0000-0000-0000-000000000040} Machine Policy Agent Cleanup

18 - {00000000-0000-0000-0000-000000000041} User Policy Agent Cleanup

19 - {00000000-0000-0000-0000-000000000042} Policy Agent Validate Machine Policy/Assignment

20 - {00000000-0000-0000-0000-000000000043} Policy Agent Validate User Policy/Assignment

21 - {00000000-0000-0000-0000-000000000051} Retrying/Refreshing Certificates in AD on MP

22 - {00000000-0000-0000-0000-000000000061} Peer DP Status Reporting

23 - {00000000-0000-0000-0000-000000000062} Peer DP Pending Package Check Schedule

24 - {00000000-0000-0000-0000-000000000063} SUM Updates Install Schedule

25 - {00000000-0000-0000-0000-000000000071} NAP action

26 - {00000000-0000-0000-0000-000000000101} Hardware Inventory Collection Cycle

27- {00000000-0000-0000-0000-000000000102} Software Inventory Collection Cycle

28 - {00000000-0000-0000-0000-000000000103} Discovery Data Collection Cycle

29 - {00000000-0000-0000-0000-000000000104} File Collection Cycle

30 - {00000000-0000-0000-0000-000000000105} IDMIF Collection Cycle

31 - {00000000-0000-0000-0000-000000000106} Software Metering Usage Report Cycle

32 - {00000000-0000-0000-0000-000000000107} Windows Installer Source List Update Cycle

33 - {00000000-0000-0000-0000-000000000108} Software Updates Assignments Evaluation Cycle -

(ConfigMgr Control Panel

Applet - Software Updates Deployment Evaluation Cycle)

34 - {00000000-0000-0000-0000-000000000109} Branch Distribution Point Maintenance Task

35 - {00000000-0000-0000-0000-000000000110} DCM Policy

36 - {00000000-0000-0000-0000-000000000111} Send Unsent State Message

37 - {00000000-0000-0000-0000-000000000112} State System Policy Cache Cleanout

 38 - {00000000-0000-0000-0000-000000000113} Scan by Update Source - (ConfigMgr Control Panel
Applet - Software Updates

Scan Cycle)

39 - {00000000-0000-0000-0000-000000000114} Update Store Policy

40 - {00000000-0000-0000-0000-000000000115} State System Policy Bulk Send High

41 - {00000000-0000-0000-0000-000000000116} State System Policy Bulk Send Low

42 - {00000000-0000-0000-0000-000000000120} AMT Status Check Policy

43 - {00000000-0000-0000-0000-000000000121} Application Manager Policy Action - (ConfigMgr

Control Panel Applet -

Application Deployment Evaluation Cycle)

44 - {00000000-0000-0000-0000-000000000122} Application Manager User Policy Action

45 - {00000000-0000-0000-0000-000000000123} Application Manager Global Evaluation Action

46 - {00000000-0000-0000-0000-000000000131} Power Management Start Summarizer

47 - {00000000-0000-0000-0000-000000000221} Endpoint Deployment Reevaluate

48 - {00000000-0000-0000-0000-000000000222} Endpoint AM Policy Reevaluate

49 - {00000000-0000-0000-0000-000000000223} External Event Detection

-------------------------- EXAMPLE 1 --------------------------

C:\PS>Initiate an SCCM Client Action on the Local Computer

Start-CMClientAction -SCCMClientAction 1

-------------------------- EXAMPLE 2 --------------------------

 C:\PS>Initiate an SCCM Client Action on a Remote Computer

Start-CMClientAction -ComputerName 'RemoteComputer1' -SCCMClientAction 1

-------------------------- EXAMPLE 3 --------------------------

C:\PS>Initiate an SCCM Client Action on Multiple Remote Computers

Start-CMClientAction -ComputerName 'RemoteComputer1', 'RemoteComputer2', 'RemoteComputer3'

-SCCMClientAction 1

-------------------------- EXAMPLE 4 --------------------------

C:\PS>Initiate an SCCM Client Action on Multiple Remote Computers Using a List of Computers in a
Text File

Start-CMClientAction -ComputerName (Get-Content -Path

"$env:userprofile\desktop\RemoteComputerList.txt") -SCCMClientAction
 1

-------------------------- EXAMPLE 5 --------------------------

C:\PS>Initiate an SCCM Client Action Bundle on the Local Computer that Runs Options 7, 38, and 33
(Machine Policy

Retrievale & Evaluation Cycle, Software Updates Scan Cycle, and Software Updates Deployment
Evaluation Cycle)

Start-CMClientAction -SCCMActionsBundle

-------------------------- EXAMPLE 6 --------------------------

C:\PS>Initiate an SCCM Client Action Bundle on a Remote Computer that Runs Options 7, 38, and 33
(Machine Policy

Retrievale & Evaluation Cycle, Software Updates Scan Cycle, and Software Updates Deployment
Evaluation Cycle)

Start-CMClientAction -ComputerName 'RemoteComputer1' -SCCMActionsBundle

 -------------------------- EXAMPLE 7 --------------------------

C:\PS>Initiate an SCCM Client Action Bundle on Multiple Remote Computers that Runs Options 7, 38,
and 33 (Machine Policy

Retrievale & Evaluation Cycle, Software Updates Scan Cycle, and Software Updates Deployment
Evaluation Cycle)

Start-CMClientAction -ComputerName 'RemoteComputer1', 'RemoteComputer2', 'RemoteComputer3'

-SCCMActionsBundle

-------------------------- EXAMPLE 8 --------------------------

C:\PS>Initiate an SCCM Client Action Bundle on Multiple Remote Computers Using a List of Computers
in a Text File that

Runs Options 7, 38, and 33 (Machine Policy Retrievale & Evaluation Cycle, Software Updates Scan
Cycle, and Software

Updates Deployment Evaluation Cycle)

Start-CMClientAction -ComputerName (Get-Content -Path

"$env:userprofile\desktop\RemoteComputerList.txt") -SCCMActionsBundle
RELATED LINKS