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>]

Описание

Используйте этот командлет, чтобы настроить синхронизацию членства в коллекции в группах Microsoft Entra для коллекции устройств или пользователей.

Примечание.

Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.

Примеры

Пример 1. Включение коллекции для синхронизации членов с группой Microsoft Entra

Первая команда получает объект коллекции с именем testUserCollection и сохраняет его в переменной $userCollection . Вторая команда получает клиент Microsoft Entra с именем contoso и сохраняет его в переменной $AADTenant . Третья команда включает синхронизацию коллекции с группой Microsoft Entra с именем testUserGroup , принадлежащей имени клиента contoso.

$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 . Вторая команда удаляет синхронизацию коллекции с группой Microsoft Entra с именем testUserGroup , принадлежащей имени клиента contoso, которая передается в качестве значения параметра -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

Перед запуском командлет запросит подтверждение.

Тип:SwitchParameter
Aliases: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

Укажите идентификатор настраиваемой коллекции. Это значение является свойством CollectionID , например XYZ00012.

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-InputObject

Укажите объект коллекции для настройки. Чтобы получить этот объект, используйте командлеты Get-CMCollection, Get-CMDeviceCollection или Get-CMUserCollection .

Тип:IResultObject
Aliases: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. Это значение является свойством 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 .

Тип:IResultObject
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Выходные данные

System.Object