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