Get-CMSoftwareUpdateAutoDeploymentRule

Get-CMSoftwareUpdateAutoDeploymentRule

Gets Configuration Manager deployment rules for automatic software updates.

Syntax

Parameter Set: SearchByName
Get-CMSoftwareUpdateAutoDeploymentRule [-Name <String> ] [ <CommonParameters>]

Parameter Set: SearchByIdMandatory
Get-CMSoftwareUpdateAutoDeploymentRule -Id <String[]> [ <CommonParameters>]

Detailed Description

The Get-CMSoftwareUpdateAutoDeploymentRule cmdlet gets specified Microsoft System Center 2012 Configuration Manager deployment rules for automatic software updates.

System Center 2012 Configuration Manager uses rules to manage automatic deployment of software updates. When a rule runs, System Center 2012 Configuration Manager adds updates that qualify for the rule to a software update group. The System Center 2012 Configuration Manager server downloads content files and copies them to distribution points, and then updates client computers.

You can specify rules by ID or by name. You can use this cmdlet to get deployment rules for automatic software updates to use with other cmdlets, such as the Invoke-CMSoftwareUpdateAutoDeploymentRule cmdlet or the Remove-CMSoftwareUpdateAutoDeploymentRule cmdlet.

Parameters

-Id<String[]>

Specifies an array of IDs for rules for automatic deployment of software updates. This value is the AutoDeploymentID property of the deployment rule object.

Aliases

AutoDeploymentId

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Name<String>

Specifies a name of a rule for automatic deployment of software updates.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Example 1: Get a deployment rule by name

This command gets a deployment rule named Weekly Driver Updates.

PS C:\> Get-CMSoftwareUpdateAutoDeploymentRule -Name "Weekly Driver Updates"

Example 2: Get a deployment rule by ID

This command gets a deployment rule that has the ID 16777217.

PS C:\> Get-CMSoftwareUpdateAutoDeploymentRule -Id "16777217"

Disable-CMSoftwareUpdateAutoDeploymentRule

Enable-CMSoftwareUpdateAutoDeploymentRule

Invoke-CMSoftwareUpdateAutoDeploymentRule

Remove-CMSoftwareUpdateAutoDeploymentRule