Remove-CMDeploymentType
Remove-CMDeploymentType
Removes a deployment type.
Syntax
Parameter Set: SearchByIdMandatory
Remove-CMDeploymentType -ApplicationName <String> -DeploymentTypeId <String> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByNameMandatory
Remove-CMDeploymentType -ApplicationName <String> -DeploymentTypeName <String> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Remove-CMDeploymentType cmdlet removes a deployment type in Microsoft System Center 2012 Configuration Manager. You cannot remove a deployment type if it is referenced by a deployment type in another application.
To remove a deployment type, you must remove any dependencies to the deployment type in other deployment types. Additionally, you must remove previous revisions of any application that contains a deployment type that references the deployment type that you want to remove. If you have already deployed the application, you cannot remove the last deployment type that the application contains, and the application must be in an active state.
Parameters
-ApplicationName<String>
Specifies the name of an application that is associated to the deployment type.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-DeploymentTypeId<String>
Specifies the ID of a deployment type.
Aliases |
CIId |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-DeploymentTypeName<String>
Specifies the name of a deployment type.
Aliases |
LocalizedDisplayName |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Force
Removes the deployment type without prompting you for confirmation. By default, the cmdlet prompts you for confirmation before it proceeds.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Confirm
Prompts you for confirmation before running the cmdlet.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
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, -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: Remove a deployment type
This command removes the deployment type named InterDept - Windows app package (.appx file) that is contained in the application named CenterApp.
PS C:\> Remove-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows app package (.appx file)"