Set-CMCollectionCloudSync
디바이스 또는 사용자 컬렉션에 대한 Microsoft Entra 그룹에 대한 컬렉션 멤버 자격 동기화를 구성합니다. 자세한 내용은 Microsoft Entra 그룹에 컬렉션 멤버를 동기화하는 방법을 참조하세요.
구문
Set-CMCollectionCloudSync
-InputObject <IResultObject#SMS_Collection>
[-AddGroupName <string[]>][-EnableAssignEndpointSecurityPolicy <bool>]
[-RemoveGroupName <string[]>]
[-TenantId <string>][-TenantName <string>]
[-TenantObject <IResultObject#SMS_AAD_Tenant_Ex>]
[-DisableWildcardHandling]
[-ForceWildcardHandling][-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMCollectionCloudSync
-Id <string>
[-AddGroupName <string[]>]
[-EnableAssignEndpointSecurityPolicy <bool>][-RemoveGroupName <string[]>]
[-TenantId <string>]
[-TenantName <string>]
[-TenantObject <IResultObject#SMS_AAD_Tenant_Ex>][-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm][<CommonParameters>] Set-CMCollectionCloudSync
-Name <string>
[-AddGroupName <string[]>]
[-EnableAssignEndpointSecurityPolicy <bool>][-RemoveGroupName <string[]>]
[-TenantId <string>]
[-TenantName <string>]
[-TenantObject <IResultObject#SMS_AAD_Tenant_Ex>][-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm][<CommonParameters>] Description
이 cmdlet을 사용하여 디바이스 또는 사용자 컬렉션에 대한 Microsoft Entra 그룹에 대한 컬렉션 멤버 자격 동기화를 구성합니다.
참고
Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.
예제
예제 1: Microsoft Entra 그룹에 멤버를 동기화하는 컬렉션 사용
첫 번째 명령은 testUserCollection 이라는 컬렉션 개체를 가져오고 $userCollection 변수에 저장합니다. 두 번째 명령은 contoso 라는 Microsoft Entra 테넌트를 가져오고 $AADTenant 변수에 저장합니다. 세 번째 명령을 사용하면 테넌트 이름 "contoso"에 속하는 testUserGroup 이라는 Microsoft Entra 그룹과 컬렉션을 동기화할 수 있습니다.
$userCollection = Get-CMCollection -Name "testUserCollection"
$AADTenant = Get-CMAADTenant -Name "contoso"
Set-CMCollectionCloudSync -InputObject $userCollection -AddGroupName "testUserGroup" -EnableAssignEndpointSecurityPolicy $true -TenantObject $AADTenant예제 2: Microsoft Entra 그룹과 컬렉션 동기화 제거
첫 번째 명령은 testUserCollection 이라는 컬렉션 개체를 가져오고 $userCollection 변수에 저장합니다. 두 번째 명령은 테넌트 이름 "contoso"에 속하는 testUserGroup 이라는 Microsoft Entra 그룹과 컬렉션의 동기화를 제거합니다. 이 그룹은 -TenantName 매개 변수의 값으로 전달됩니다. 또는 -TenantId 매개 변수를 사용할 수도 있습니다.
$userCollection = Get-CMCollection -Name "testUserCollection"
Set-CMCollectionCloudSync -InputObject $userCollection -RemoveGroupName "testUserGroup" -EnableAssignEndpointSecurityPolicy $true -TenantName "contoso"매개 변수
-AADGroupName
컬렉션의 멤버를 동기화해야 하는 대상 Microsoft Entra 그룹 이름을 지정합니다.
| 형식: | 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 |
-EnableAssignEndpointSecurityPolicy
이 매개 변수를 사용하여 Intune 포털에 표시할 컬렉션을 사용하거나 사용하지 않도록 설정하여 테넌트 연결 시나리오에서 엔드포인트 보안 정책을 할당합니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ForceWildcardHandling
이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Id
구성할 컬렉션의 ID를 지정합니다. 이 값은 CollectionID 속성(예: XYZ00012)입니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-InputObject
구성할 컬렉션 개체를 지정합니다. 이 개체를 얻으려면 Get-CMCollection, Get-CMDeviceCollection 또는 Get-CMUserCollection cmdlet을 사용합니다.
| 형식: | IResultObject |
| 별칭: | Collection |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Name
구성할 컬렉션의 이름을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-RemoveGroupName
이 매개 변수를 사용하여 지정된 Microsoft Entra 그룹과의 동기화를 제거합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-TenantId
Microsoft Entra 테넌트 ID를 지정합니다. 이 값은 TenantId 속성(예: 72f988bf-00ab-11cd-22ef-2d7cd011db00)입니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-TenantName
Microsoft Entra 테넌트 이름을 지정합니다(예: contoso).
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-TenantObject
Microsoft Entra 테넌트 개체를 지정합니다. 이 개체를 얻으려면 Get-CMAADTenant cmdlet을 사용합니다.
| 형식: | IResultObject |
| 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