Partager via


Set-CMApplicationSupersedence

Définir le remplacement du type de déploiement pour une 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

Utilisez cette applet de commande pour définir le remplacement du type de déploiement pour l’application spécifiée.

Pour plus d’informations, consultez Remplacer des applications.

Remarque

Exécutez Configuration Manager applets de commande à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Ajouter le remplacement du type de déploiement

$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)

Exemple 2 : Supprimer le remplacement du type de déploiement

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

Paramètres

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

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

-CurrentDeploymentType

Spécifiez un objet de type de déploiement à partir de l’application de remplacement . Pour obtenir cet objet, utilisez l’applet de commande Get-CMDeploymentType .

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

-CurrentDeploymentTypeId

Spécifiez l’ID d’un type de déploiement à partir de l’application de remplacement .

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

Spécifiez le nom d’un type de déploiement à partir de l’application de remplacement .

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

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

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

-Force

Ajoutez ce paramètre pour exécuter la commande sans demander de confirmation.

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

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

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

-Id

Spécifiez l’ID de l’application actuelle (de remplacement).

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

-InputObject

Spécifiez un objet pour l’application actuelle (de remplacement). Pour obtenir cet objet, utilisez l’applet de commande Get-CMApplication .

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

-IsUninstall

Définissez ce paramètre sur $true pour désinstaller l’application remplacée avant que le client n’installe l’application de remplacement.

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

-Name

Spécifiez le nom d’affichage localisé de l’application actuelle (de remplacement).

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

-OldDeploymentType

Spécifiez un objet de type de déploiement à partir de l’application remplacée . Pour obtenir cet objet, utilisez l’applet de commande Get-CMDeploymentType .

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

-OldDeploymentTypeId

Spécifiez l’ID d’un type de déploiement à partir de l’application remplacée .

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

Spécifiez le nom d’un type de déploiement à partir de l’application remplacée .

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

-PassThru

Ajoutez ce paramètre pour renvoyer un objet qui représente l’élément avec lequel vous travaillez. Par défaut, cette applet de commande peut ne pas générer de sortie.

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

-RemoveSupersedence

Ajoutez ce paramètre pour supprimer la relation de remplacement.

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

-SupersededApplication

Spécifiez un objet pour l’ancienne application (remplacée). Pour obtenir cet objet, utilisez l’applet de commande Get-CMApplication .

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

-SupersededApplicationId

Spécifiez l’ID de l’ancienne application (remplacée).

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

-SupersededApplicationName

Spécifiez le nom d’affichage localisé de l’ancienne application (remplacée).

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

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

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

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object