다음을 통해 공유

Add-CMUserCollectionExcludeMembershipRule

  • 참조
모듈:
ConfigurationManager

사용자 컬렉션에 제외 멤버 자격 규칙을 추가합니다.

구문

Add-CMUserCollectionExcludeMembershipRule
   -CollectionName <String>
   -ExcludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMUserCollectionExcludeMembershipRule
   -CollectionName <String>
   -ExcludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMUserCollectionExcludeMembershipRule
   -CollectionName <String>
   -ExcludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMUserCollectionExcludeMembershipRule
   -CollectionId <String>
   -ExcludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMUserCollectionExcludeMembershipRule
   -CollectionId <String>
   -ExcludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMUserCollectionExcludeMembershipRule
   -CollectionId <String>
   -ExcludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMUserCollectionExcludeMembershipRule
   -InputObject <IResultObject>
   -ExcludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMUserCollectionExcludeMembershipRule
   -InputObject <IResultObject>
   -ExcludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMUserCollectionExcludeMembershipRule
   -InputObject <IResultObject>
   -ExcludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

이 cmdlet을 사용하여 사용자 컬렉션에 제외 멤버 자격 규칙을 추가합니다. 제외 멤버 자격 규칙은 규칙이 적용되는 사용자 컬렉션에서 다른 컬렉션의 멤버를 제외합니다.

기본 컬렉션에는 멤버 자격 규칙을 추가할 수 없습니다. 대상으로 하는 모든 컬렉션에는 가 아닌 SMS사이트 코드로 시작하는 ID가 있어야 합니다. 기본 컬렉션을 제외할 수 있으므로 제외된 컬렉션의 ID는 로 SMS시작할 수 있습니다.

제외된 컬렉션의 멤버 자격이 변경되는 경우 Configuration Manager는 일정에 따라 사용자 컬렉션의 멤버 자격을 동적으로 업데이트합니다.

컬렉션에 제외 멤버 자격 규칙을 추가하면 리소스가 더 이상 사용자 컬렉션의 멤버가 아닐 수 있습니다. 이 작업을 수행하면 소프트웨어 또는 구성 배포가 사용자에게 적용되지 않을 수 있습니다.

자세한 내용은 Configuration Manager에서 컬렉션을 만드는 방법을 참조하세요.

참고

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

예제

예제 1: 사용자 컬렉션에 제외 컬렉션 규칙 추가

이 명령은 ID가 XYZ00017있는 원격 사용자 컬렉션의 멤버를 ID XYZ00012 있는 사용자 컬렉션에서 제외합니다.

Add-CMUserCollectionExcludeMembershipRule -CollectionId "XYZ00012" -ExcludeCollectionId "XYZ00017"

매개 변수

-CollectionId

규칙을 추가할 사용자 컬렉션의 ID를 지정합니다. 이 값은 CollectionID 속성(예: XYZ00012)입니다. 기본 컬렉션에는 제외 멤버 자격 규칙이 없으므로 이 ID는 가 아닌 SMS사이트 코드로 시작합니다.

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

-CollectionName

규칙을 추가할 사용자 컬렉션의 이름을 지정합니다.

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

-Confirm

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

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

-ExcludeCollection

제외된 컬렉션에 대한 개체를 지정하여 규칙을 추가합니다. 이 개체를 얻으려면 Get-CMCollection 또는 Get-CMUserCollection cmdlet을 사용합니다.

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

-ExcludeCollectionId

제외된 컬렉션의 ID를 지정하여 규칙을 추가합니다. 이 값은 CollectionID 속성(예: XYZ00012)입니다. 기본 컬렉션을 제외할 수 있으므로 이 값은 사이트 코드 또는 SMS로 시작할 수 있습니다.

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

-ExcludeCollectionName

제외된 컬렉션의 이름을 지정하여 규칙을 추가합니다.

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

-InputObject

규칙을 추가할 사용자 컬렉션에 대한 개체를 지정합니다. 이 개체를 얻으려면 Get-CMCollection 또는 Get-CMUserCollection cmdlet을 사용합니다.

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

-PassThru

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

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

-WhatIf

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

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

입력

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

출력

System.Object