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"
Related topics
Disable-CMSoftwareUpdateAutoDeploymentRule
Enable-CMSoftwareUpdateAutoDeploymentRule