Set-CMApplicationSupersedence

模块:

ConfigurationManager

设置应用程序的部署类型取代。

语法

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>]

说明

使用此 cmdlet 为指定应用程序设置部署类型取代。

有关详细信息，请参阅 取代应用程序。

注意

从Configuration Manager站点驱动器运行Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。

示例

示例 1：添加部署类型取代

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

示例 2：删除部署类型取代

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

参数

-Confirm

提示你在运行 cmdlet 之前进行确认。

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

-CurrentDeploymentType

从 取代 应用程序指定部署类型对象。 若要获取此对象，请使用 Get-CMDeploymentType cmdlet。

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

-CurrentDeploymentTypeId

指定 取代 应用程序中的部署类型的 ID。

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

指定 取代 应用程序中的部署类型的名称。

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

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

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

-Force

添加此参数以在不要求确认的情况下运行命令。

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

-ForceWildcardHandling

此参数处理通配符，并可能导致意外行为 (不建议) 。 不能将其与 DisableWildcardHandling 结合使用。

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

-Id

指定当前 (取代) 应用程序的 ID。

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

-InputObject

为当前 (取代) 应用程序指定对象。 若要获取此对象，请使用 Get-CMApplication cmdlet。

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

-IsUninstall

将此参数设置为 以 $true 在客户端安装取代应用程序之前卸载被取代的应用程序。

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

-Name

指定当前 (取代) 应用程序的本地化显示名称。

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

-OldDeploymentType

从 被取代 的应用程序指定部署类型对象。 若要获取此对象，请使用 Get-CMDeploymentType cmdlet。

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

-OldDeploymentTypeId

从 被取代 的应用程序指定部署类型的 ID。

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

从 被取代 的应用程序指定部署类型的名称。

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

-PassThru

添加此参数可返回一个对象，该对象表示正在使用的项。 默认情况下，此 cmdlet 可能不会生成任何输出。

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

-RemoveSupersedence

添加此参数可删除取代关系。

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

-SupersededApplication

为取代的 旧 () 应用程序指定对象。 若要获取此对象，请使用 Get-CMApplication cmdlet。

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

-SupersededApplicationId

指定被 取代 的旧 () 应用程序的 ID。

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

-SupersededApplicationName

指定被 取代 的旧 () 应用程序的本地化显示名称。

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

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object

相关链接

• Get-CMApplication
• Get-CMDeploymentType
• 取代应用程序