Set-CMApplicationSupersedence
設定應用程式的部署類型取代。
語法
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
使用此 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 之前提示您確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-CurrentDeploymentType
從 取代的 應用程式指定部署類型物件。 若要取得這個物件,請使用 Get-CMDeploymentType Cmdlet。
| 類型: | IResultObject |
| 別名: | ReplacementDeploymentType, SupersedingDeploymentType |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-CurrentDeploymentTypeId
從 取代 的應用程式指定部署類型的標識碼。
| 類型: | Int32 |
| 別名: | CurrentDeploymentTypeCIId, CurrentDeploymentTypeCI_ID, ReplacementDeploymentTypeId, ReplacementDeploymentTypeCIId, ReplacementDeploymentTypeCI_ID, SupersedingDeploymentTypeId, SupersedingDeploymentTypeCIId, SupersedingDeploymentTypeCI_ID |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-CurrentDeploymentTypeName
從 取代 的應用程式指定部署類型的名稱。
| 類型: | String |
| 別名: | ReplacementDeploymentTypeName, SupersedingDeploymentTypeName |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Force
新增此參數以執行命令,而不要求確認。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符,並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Id
指定目前 (取代) 應用程式 的 識別碼。
| 類型: | Int32 |
| 別名: | ApplicationId, CurrentApplicationId, CurrentApplicationCIId, CurrentApplicationCI_ID |
| Position: | 0 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-InputObject
指定目前 (取代) 應用程式 的 物件。 若要取得此物件,請使用 Get-CMApplication Cmdlet。
| 類型: | IResultObject |
| 別名: | Application, CurrentApplication |
| Position: | 0 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-IsUninstall
將此參數設定為 $true ,以在用戶端安裝取代的應用程式之前卸載已取代的應用程式。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Name
指定目前 (取代) 應用程式的當地語系化顯示名稱。
| 類型: | String |
| 別名: | ApplicationName, LocalizedDisplayName, CurrentApplicationName, CurrentApplicationLocalizedDisplayName |
| Position: | 0 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-OldDeploymentType
從 已取代的 應用程式指定部署類型物件。 若要取得這個物件,請使用 Get-CMDeploymentType Cmdlet。
| 類型: | IResultObject |
| 別名: | SupersededDeploymentType |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-OldDeploymentTypeId
從 已取代 的應用程式指定部署類型的標識碼。
| 類型: | Int32 |
| 別名: | OldDeploymentTypeCIId, OldDeploymentTypeCI_ID, SupersededDeploymentTypeId, SupersededDeploymentTypeCIId, SupersededDeploymentTypeCI_ID |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-OldDeploymentTypeName
從 已取代 的應用程式指定部署類型的名稱。
| 類型: | String |
| 別名: | SupersededDeploymentTypeName |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-PassThru
新增此參數以傳回 物件,代表您正在使用的專案。 根據預設,此 Cmdlet 可能不會產生任何輸出。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-RemoveSupersedence
新增此參數以移除取代關聯性。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SupersededApplication
指定舊 (取代) 應用程式 的 物件。 若要取得此物件,請使用 Get-CMApplication Cmdlet。
| 類型: | IResultObject |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SupersededApplicationId
指定舊 (取代) 應用程式的識別碼。
| 類型: | Int32 |
| 別名: | SupersededApplicationCIId, SupersededApplicationCI_ID |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SupersededApplicationName
指定舊 (取代) 應用程式的當地語系化顯示名稱。
| 類型: | String |
| 別名: | SupersededApplicationLocalizedDisplayName |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
輸出
System.Object