Remove-CMDeployment
拿掉部署。
語法
Remove-CMDeployment
[-Force]
-InputObject <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Remove-CMDeployment
-ApplicationName <String>
-DeploymentId <String>
[-Force]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Remove-CMDeployment
-ApplicationName <String>
-CollectionName <String>
[-Force]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
Remove-CMDeployment Cmdlet 會從 Configuration Manager 移除應用程式部署。
當您移除應用程式部署時，Configuration Manager 不會移除已安裝之應用程式的實例。 若要移除這些應用程式，您必須使用 [卸載] 動作將應用程式部署到計算機。 如果您刪除應用程式部署，或從您要部署的集合中移除資源，應用程式將不再顯示在軟體中心。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。
範例
範例 1：移除應用程式部署
PS XYZ:\> Remove-CMDeployment -ApplicationName "CMappD01" -CollectionName "All Users"此命令會移除與名為 CMappD01 的應用程式相關聯且已套用至名為 [所有使用者] 之集合的 Configuration Manager 部署。
範例 2：傳遞部署物件並將其移除
PS XYZ:\> Get-CMDeployment -CollectionName "deviceCol01" -FeatureType Application | Remove-CMDeployment -Force此命令會取得名為 deiceCol01 之集合的指定應用程式部署物件，並使用管線運算符將對象傳遞至 Remove-CMDeployment，以移除部署。 由於已指定 Force 參數，因此在移除部署之前不會提示使用者。
範例 3：依標識符移除部署
PS XYZ:\> Remove-CMDeployment -DeploymentId "{890082B6-7C16-4600-8807-7E0003BC9D99}" -ApplicationName "application01" -Force此命令會移除具有指定標識碼的名為application01的部署。 由於已指定 Force 參數，因此在移除部署之前不會提示使用者。
參數
-ApplicationName
指定與部署相關聯的應用程式名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-CollectionName
指定與部署相關聯之集合的名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | True |
-Confirm
執行 Cmdlet 之前提示您確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DeploymentId
指定部署的識別碼。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | 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 |
-InputObject
指定部署物件。 若要取得部署物件，請使用 Get-CMDeployment Cmdlet。
| 類型: | IResultObject |
| 別名: | Deployment |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
輸出
System.Object