Set-CMApplicationSupersedence

Module:

ConfigurationManager

Set deployment type supersedence for an application.

Syntax

Set-CMApplicationSupersedence
   [-Id] <Int32>
   [-CurrentDeploymentTypeId <Int32>]
   [-CurrentDeploymentTypeName <String>]
   [-CurrentDeploymentType <IResultObject>]
   [-SupersededApplicationId <Int32>]
   [-SupersededApplicationName <String>]
   [-SupersededApplication <IResultObject>]
   [-OldDeploymentTypeId <Int32>]
   [-OldDeploymentTypeName <String>]
   [-OldDeploymentType <IResultObject>]
   [-IsUninstall <Boolean>]
   [-RemoveSupersedence]
   [-Force]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationSupersedence
   [-Name] <String>
   [-CurrentDeploymentTypeId <Int32>]
   [-CurrentDeploymentTypeName <String>]
   [-CurrentDeploymentType <IResultObject>]
   [-SupersededApplicationId <Int32>]
   [-SupersededApplicationName <String>]
   [-SupersededApplication <IResultObject>]
   [-OldDeploymentTypeId <Int32>]
   [-OldDeploymentTypeName <String>]
   [-OldDeploymentType <IResultObject>]
   [-IsUninstall <Boolean>]
   [-RemoveSupersedence]
   [-Force]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationSupersedence
   [-InputObject] <IResultObject>
   [-CurrentDeploymentTypeId <Int32>]
   [-CurrentDeploymentTypeName <String>]
   [-CurrentDeploymentType <IResultObject>]
   [-SupersededApplicationId <Int32>]
   [-SupersededApplicationName <String>]
   [-SupersededApplication <IResultObject>]
   [-OldDeploymentTypeId <Int32>]
   [-OldDeploymentTypeName <String>]
   [-OldDeploymentType <IResultObject>]
   [-IsUninstall <Boolean>]
   [-RemoveSupersedence]
   [-Force]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use this cmdlet to set deployment type supersedence for the specified application.

For more information, see Supersede applications.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Examples

Example 1: Add deployment type supersedence

$AppSupersededName = "Superseded app"
$AppSuperseded = New-CMApplication -Name $AppSupersededName
$OriginalDT = Add-CMScriptDeploymentType -ApplicationName $AppSuperseded -DeploymentTypeName "ScriptDT01" -InstallCommand 'appsetup.exe'

$AppSupersedingName = "Superseding app"
$AppSuperseding = New-CMApplication -Name $AppSupersedingName
$AppSupersedingDT = Add-CMScriptDeploymentType -ApplicationName $AppSuperseding -DeploymentTypeName "ScriptDT02" -InstallCommand 'appsetup2.exe'

Set-CMApplicationSupersedence -ApplicationId ($AppSuperseding.CI_ID) -CurrentDeploymentTypeId ($AppSupersedingDT.CI_ID) -SupersededApplicationId ($AppSuperseded.CI_ID) -OldDeploymentTypeId ($OriginalDT.CI_ID)

Example 2: Remove deployment type supersedence

Set-CMApplicationSupersedence -ApplicationName $AppSupersedingName -CurrentDeploymentTypeName ($AppSupersedingDT.LocalizedDisplayName) -SupersededApplicationName $AppSupersededName -OldDeploymentTypeName ($OriginalDT.LocalizedDisplayName) -RemoveSupersedence -Force

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CurrentDeploymentType

Specify a deployment type object from the superseding application. To get this object, use the Get-CMDeploymentType cmdlet.

Type:	IResultObject
Aliases:	ReplacementDeploymentType, SupersedingDeploymentType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CurrentDeploymentTypeId

Specify the ID of a deployment type from the superseding application.

Type:	Int32
Aliases:	CurrentDeploymentTypeCIId, CurrentDeploymentTypeCI_ID, ReplacementDeploymentTypeId, ReplacementDeploymentTypeCIId, ReplacementDeploymentTypeCI_ID, SupersedingDeploymentTypeId, SupersedingDeploymentTypeCIId, SupersedingDeploymentTypeCI_ID
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CurrentDeploymentTypeName

Specify the name of a deployment type from the superseding application.

Type:	String
Aliases:	ReplacementDeploymentTypeName, SupersedingDeploymentTypeName
Position:	Named
Default value:	None
Required:	False
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

-Force

Add this parameter to run the command without asking for confirmation.

Type:	SwitchParameter
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

-Id

Specify the ID of the current (superseding) application.

Type:	Int32
Aliases:	ApplicationId, CurrentApplicationId, CurrentApplicationCIId, CurrentApplicationCI_ID
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Specify an object for the current (superseding) application. To get this object, use the Get-CMApplication cmdlet.

Type:	IResultObject
Aliases:	Application, CurrentApplication
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-IsUninstall

Set this parameter to $true to uninstall the superseded application before the client installs the superseding application.

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

-Name

Specify the localized display name of the current (superseding) application.

Type:	String
Aliases:	ApplicationName, LocalizedDisplayName, CurrentApplicationName, CurrentApplicationLocalizedDisplayName
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-OldDeploymentType

Specify a deployment type object from the superseded application. To get this object, use the Get-CMDeploymentType cmdlet.

Type:	IResultObject
Aliases:	SupersededDeploymentType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OldDeploymentTypeId

Specify the ID of a deployment type from the superseded application.

Type:	Int32
Aliases:	OldDeploymentTypeCIId, OldDeploymentTypeCI_ID, SupersededDeploymentTypeId, SupersededDeploymentTypeCIId, SupersededDeploymentTypeCI_ID
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OldDeploymentTypeName

Specify the name of a deployment type from the superseded application.

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

-PassThru

Add this parameter to return an object that represents the item with which you're working. By default, this cmdlet may not generate any output.

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

-RemoveSupersedence

Add this parameter to remove the supersedence relationship.

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

-SupersededApplication

Specify an object for the old (superseded) application. To get this object, use the Get-CMApplication cmdlet.

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

-SupersededApplicationId

Specify the ID of the old (superseded) application.

Type:	Int32
Aliases:	SupersededApplicationCIId, SupersededApplicationCI_ID
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SupersededApplicationName

Specify the localized display name of the old (superseded) application.

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet doesn't run.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Inputs

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Outputs

System.Object

Related Links

• Get-CMApplication
• Get-CMDeploymentType
• Supersede applications