Get-CMDeployment
Get 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 Configuration Manager deployments. The cmdlet gets summary information about deployments of applications, software updates, or classic programs.
Note
Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>
. For more information, see getting started.
Examples
Example 1: Get a deployment for a collection
This command gets the application deployment for the device collection named deviceCol1.
Get-CMDeployment -CollectionName "deviceCol1" -FeatureType "Application"
Parameters
-CollectionName
Specifies the name of the collection associated with the deployment.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-DeploymentId
Specifies the ID of a deployment.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FeatureType
Specifies the feature type of the deployment.
Type: | DeploymentFeature |
Accepted values: | Application, Package, SoftwareUpdate, ConfigurationItem, TaskSequence, FirewallSetting, ApplicationGroup |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
Inputs
None
Outputs
IResultObject[]
IResultObject