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 группы, с которой необходимо синхронизировать члены коллекции.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Перед запуском командлет запросит подтверждение.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableAssignEndpointSecurityPolicy
Используйте этот параметр, чтобы включить или отключить коллекцию для отображения на портале Intune для назначения политик безопасности конечных точек в сценарии присоединения клиента.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Id
Укажите идентификатор настраиваемой коллекции. Это значение является свойством CollectionID , например XYZ00012.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Укажите объект коллекции для настройки. Чтобы получить этот объект, используйте командлеты Get-CMCollection, Get-CMDeviceCollection или Get-CMUserCollection .
| Type: | IResultObject |
| Aliases: | Collection |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Укажите имя настраиваемой коллекции.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveGroupName
Этот параметр используется для удаления синхронизации с указанной Microsoft Entra группой.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TenantId
Укажите идентификатор клиента Microsoft Entra. Это значение является свойством TenantId , например 72f988bf-00ab-11cd-22ef-2d7cd011db00.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TenantName
Укажите имя клиента Microsoft Entra, например contoso.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TenantObject
Укажите объект для клиента Microsoft Entra. Чтобы получить этот объект, используйте командлет Get-CMAADTenant .
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Входные данные
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Выходные данные
System.Object
Связанные ссылки
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по