Add-CMDeviceCollectionIncludeMembershipRule
디바이스 컬렉션에 포함 멤버 자격 규칙을 추가합니다.
구문
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