Add-CMDeviceCollectionDirectMembershipRule

  • 참조
모듈:
ConfigurationManager

디바이스 컬렉션에 직접 멤버 자격 규칙을 추가합니다.

구문

Add-CMDeviceCollectionDirectMembershipRule
   -CollectionId <String>
   [-PassThru]
   -ResourceId <Int32[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionDirectMembershipRule
   -CollectionId <String>
   [-PassThru]
   -Resource <IResultObject[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionDirectMembershipRule
   -CollectionName <String>
   [-PassThru]
   -ResourceId <Int32[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionDirectMembershipRule
   -CollectionName <String>
   [-PassThru]
   -Resource <IResultObject[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionDirectMembershipRule
   -InputObject <IResultObject>
   [-PassThru]
   -ResourceId <Int32[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionDirectMembershipRule
   -InputObject <IResultObject>
   [-PassThru]
   -Resource <IResultObject[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

이 cmdlet을 사용하여 디바이스 컬렉션에 직접 멤버 자격 규칙을 추가합니다. 직접 멤버 자격 규칙을 사용하면 디바이스 컬렉션의 멤버를 명시적으로 선택할 수 있습니다. 기본 컬렉션에는 멤버 자격 규칙을 추가할 수 없습니다. 대상으로 하는 모든 컬렉션에는 가 아닌 SMS사이트 코드로 시작하는 ID가 있어야 합니다. 자세한 내용은 Configuration Manager에서 컬렉션을 만드는 방법을 참조하세요.

참고

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

예제

예제 1: 직접 멤버 자격 규칙 추가

이 명령은 ID XYZ00056 사용하여 디바이스 컬렉션에 직접 멤버 자격 규칙을 추가합니다. ID 16777219 있는 리소스를 컬렉션에 추가합니다.

Add-CMDeviceCollectionDirectMembershipRule -CollectionId "XYZ00056" -ResourceId 16777219

예제 2: 파이프라인을 사용하여 직접 멤버 자격 규칙 추가

이 명령은 먼저 Get-CMCollection cmdlet을 사용하여 testCollection이라는 컬렉션 개체를 가져옵니다. 그런 다음 파이프라인 연산자를 사용하여 개체를 Add-CMDeviceCollectionDirectMembershipRule cmdlet에 전달하여 디바이스 컬렉션 개체에 직접 멤버 자격 규칙을 추가합니다. ID 16777219 있는 디바이스를 컬렉션에 추가합니다.

Get-CMCollection -Name "testCollection" | Add-CMDeviceCollectionDirectMembershipRule -ResourceId 16777219

매개 변수

-CollectionId

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

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

-CollectionName

규칙을 추가할 디바이스 컬렉션의 이름을 지정합니다.

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

-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-CMCollection 또는 Get-CMDeviceCollection cmdlet을 사용합니다.

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

-PassThru

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

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

-Resource

이 직접 멤버 자격 규칙을 사용하여 디바이스 컬렉션에 추가할 리소스 개체의 배열을 지정합니다. 이 개체를 얻으려면 Get-CMResource cmdlet 또는 매개 변수와 함께 Get-CMDevice cmdlet을 -Resource 사용합니다.

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

-ResourceId

이 직접 멤버 자격 규칙을 사용하여 디바이스 컬렉션에 추가할 리소스의 ID 배열을 지정합니다. 이 값은 ResourceID 속성(예 16777219: )입니다.

형식:Int32[]
별칭:ResourceIds
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

출력

System.Object