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: ID로 배포 제거
PS XYZ:\> Remove-CMDeployment -DeploymentId "{890082B6-7C16-4600-8807-7E0003BC9D99}" -ApplicationName "application01" -Force
이 명령은 지정된 ID를 사용하여 application01이라는 배포를 제거합니다. Force 매개 변수가 지정되었으므로 배포를 제거하기 전에 사용자에게 메시지가 표시되지 않습니다.
매개 변수
-ApplicationName
배포와 연결된 애플리케이션의 이름을 지정합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-CollectionName
배포와 연결된 컬렉션의 이름을 지정합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | True |
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
형식: | SwitchParameter |
별칭: | cf |
Position: | Named |
Default value: | False |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-DeploymentId
배포의 ID를 지정합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-DisableWildcardHandling
이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Force
확인 메시지 없이 작업을 수행합니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ForceWildcardHandling
이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-InputObject
배포 개체를 지정합니다. 배포 개체를 가져오려면 Get-CMDeployment cmdlet을 사용합니다.
형식: | IResultObject |
별칭: | Deployment |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.
형식: | SwitchParameter |
별칭: | wi |
Position: | Named |
Default value: | False |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
입력
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
출력
System.Object