Get-CMDeployment

Gets a Configuration Manager deployment.

Syntax

Get-CMDeployment
   [-CollectionName <String>]
   [-FeatureType <DeploymentFeature>]
   [-ProgramName <String>]
   [-SoftwareName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMDeployment
   -DeploymentId <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

The Get-CMDeployment cmdlet gets one or more Microsoft System Center Configuration Manager deployments. The cmdlet gets summary information about application, Software Update Management (SUM), or classic program deployments.

Examples

Example 1: Get a deployment for a collection

PS C:\> Get-CMDeployment -CollectionName "deviceCol1" -FeatureType "Application"

This command gets the Application deployment for the device collection named deviceCol1.

Required Parameters

-DeploymentId

Specifies the ID of a deployment.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-CollectionName

Specifies the name of the collection associated with the deployment.

Type:String
Position:Named
Default value:None
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
-FeatureType

Specifies the feature type of the deployment. Valid values are:

  • Application
  • Package
  • SoftwareUpdate
  • ConfigurationItem
  • TaskSequence
  • FirewallSetting
Type:DeploymentFeature
Parameter Sets:Application, Package, SoftwareUpdate, ConfigurationItem, TaskSequence, FirewallSetting
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
-ProgramName

Specifies the name of the program associated with the deployment. Use this parameter with a legacy distribution program.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SoftwareName

Specifies the name of the software associated with the deployment. Use this parameter with a software update.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False