Disable-CMProgram

패키지에서 프로그램을 사용하지 않도록 설정합니다.

구문

Disable-CMProgram
       -InputObject <IResultObject>
       [-PassThru]
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Disable-CMProgram
       -PackageId <String>
       [-PassThru]
       -ProgramName <String>
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Disable-CMProgram
       -PackageName <String>
       [-PassThru]
       -ProgramName <String>
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

이 cmdlet을 사용하여 패키지에서 프로그램을 사용하지 않도록 설정합니다.

Configuration Manager 클라이언트가 프로그램을 실행하지 못하도록 프로그램을 사용하지 않도록 설정합니다. 프로그램을 사용하지 않도록 설정하면 Configuration Manager는 여전히 패키지 콘텐츠를 배포 지점에 배포하고 프로그램 배포를 클라이언트에 보냅니다. 클라이언트는 클라이언트에서 프로그램을 표시하거나 실행하지 않습니다. 이 동작은 프로그램 배포를 사용하지 않도록 설정할 때 동일합니다.

참고

Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.

예제

예제 1: 프로그램 사용 안 함

이 명령은 ID가 XYZ00007 패키지에서 ProgramD02라는 프로그램을 사용하지 않도록 설정합니다.

Disable-CMProgram -PackageId "XYZ00007" -ProgramName "ProgramD02"

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

형식:SwitchParameter
별칭:cf
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DisableWildcardHandling

이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ForceWildcardHandling

이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-InputObject

사용하지 않도록 설정할 프로그램 개체를 지정합니다. 이 개체를 얻으려면 Get-CMProgram cmdlet을 사용합니다.

형식:IResultObject
별칭:Program
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-PackageId

사용하지 않도록 설정할 프로그램을 사용하여 패키지의 ID를 지정합니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PackageName

사용하지 않도록 설정할 프로그램을 사용하여 패키지의 이름을 지정합니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PassThru

작업 중인 항목을 나타내는 개체를 반환하려면 이 매개 변수를 추가합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않을 수 있습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ProgramName

사용하지 않도록 설정할 프로그램을 사용하여 패키지의 이름을 지정합니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.

형식:SwitchParameter
별칭:wi
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

출력

IResultObject

참고

이 반환 개체 및 해당 속성에 대한 자세한 내용은 SMS_Program 서버 WMI 클래스를 참조하세요.