Add-CMDeviceCollectionIncludeMembershipRule

  • 참조
모듈:
ConfigurationManager

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

구문

Add-CMDeviceCollectionIncludeMembershipRule
   -CollectionName <String>
   -IncludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionIncludeMembershipRule
   -CollectionName <String>
   -IncludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionIncludeMembershipRule
   -CollectionName <String>
   -IncludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionIncludeMembershipRule
   -CollectionId <String>
   -IncludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionIncludeMembershipRule
   -CollectionId <String>
   -IncludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionIncludeMembershipRule
   -CollectionId <String>
   -IncludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionIncludeMembershipRule
   -InputObject <IResultObject>
   -IncludeCollection <IResultObject>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionIncludeMembershipRule
   -InputObject <IResultObject>
   -IncludeCollectionId <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDeviceCollectionIncludeMembershipRule
   -InputObject <IResultObject>
   -IncludeCollectionName <String>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

이 cmdlet을 사용하여 디바이스 컬렉션에 포함 멤버 자격 규칙을 추가합니다. 포함 멤버 자격 규칙에는 규칙이 적용되는 디바이스 컬렉션에 대한 다른 컬렉션의 멤버가 포함됩니다.

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

Configuration Manager는 포함된 컬렉션의 멤버 자격이 변경되는 경우 일정에 따라 디바이스 컬렉션의 멤버 자격을 동적으로 업데이트합니다.

컬렉션에 포함 멤버 자격 규칙을 추가하면 리소스가 컬렉션의 멤버가 될 수 있습니다. 이 작업을 수행하면 포함된 컬렉션의 디바이스에 소프트웨어 또는 구성 배포가 적용될 수 있습니다.

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

참고

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

예제

예제 1: 포함 멤버 자격 규칙 추가

이 명령은 포함 멤버 자격 규칙을 사용하여 All Systems 라는 디바이스 컬렉션을 추가합니다. 규칙은 Device라는 디바이스 컬렉션에 추가됩니다.

Add-CMDeviceCollectionIncludeMembershipRule -CollectionName "Device" -IncludeCollectionName "All Systems"

예제 2: 파이프라인을 사용하여 컬렉션에 포함 멤버 자격 규칙 추가

이 명령은 먼저 Get-CMCollection cmdlet을 사용하여 Device라는 대상 컬렉션 개체를 가져옵니다. 그런 다음 파이프라인 연산자를 사용하여 개체를 Add-CMDeviceCollectionIncludeMembershipRule cmdlet에 전달하여 All Systems라는 디바이스 컬렉션에 대한 포함 멤버 자격 규칙을 추가합니다.

Get-CMCollection -Name "Device" | Add-CMDeviceCollectionIncludeMembershipRule -IncludeCollectionName "All Systems"

매개 변수

-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

-IncludeCollection

규칙에 추가할 포함된 컬렉션의 개체를 지정합니다. 이 개체를 얻으려면 Get-CMCollection 또는 Get-CMDeviceCollection cmdlet을 사용합니다.

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

-IncludeCollectionId

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

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

-IncludeCollectionName

규칙에 추가할 포함된 컬렉션의 이름을 지정합니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용: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

-WhatIf

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

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

입력

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

출력

System.Object