Add-UnifiedGroupLinks
Этот командлет доступен только в облачной службе.
Используйте командлет Add-UnifiedGroupLinks, чтобы добавить участников, владельцев и подписчиков в Группы Microsoft 365 в облачной организации. Чтобы удалить участников, владельцев и подписчиков, используйте командлет Remove-UnifiedGroupLinks. Чтобы изменить другие свойства Группы Microsoft 365, используйте командлет Set-UnifiedGroup.
Примечание.
Этот командлет нельзя использовать для изменения членов, владельцев или подписчиков группы Microsoft 365 при подключении с использованием проверки подлинности на основе сертификата (также известной как CBA или проверка подлинности только для приложений для автоматических сценариев) или Azure управляемого удостоверения. Вместо этого вы можете использовать Microsoft Graph. Дополнительные сведения см. в разделе Тип ресурса группы.
С помощью этого командлета только члены группы могут быть владельцами группы. Добавьте пользователей в качестве участников, прежде чем добавлять их в качестве владельцев. Это ограничение не применяется на порталах веб-управления, на которых можно добавлять в качестве владельцев групп, не являющихся участниками. Гостевые пользователи никогда не могут быть владельцами групп.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Default (По умолчанию)
Add-UnifiedGroupLinks
[-Identity] <UnifiedGroupIdParameter>
-Links <RecipientIdParameter[]>
-LinkType <LinkType>
[-Confirm]
[-WhatIf]
[<CommonParameters>]
Описание
Группы Microsoft 365 — это объекты групп, доступные в службах Microsoft 365.
Для его запуска необходимо получить соответствующие разрешения. Хотя в этой статье перечислены все параметры командлета, у вас может не быть доступа к некоторым параметрам, если они не включены в назначенные вам разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примечание. Владельцами группы могут быть только участники, поэтому сначала необходимо добавить пользователя в качестве участника, прежде чем добавлять его в качестве владельца. Гостевые пользователи не могут быть владельцами групп, даже если они являются членами групп.
Примеры
Пример 1
Add-UnifiedGroupLinks -Identity "Legal Department" -LinkType Members -Links chris@contoso.com,michelle@contoso.com
В этом примере добавляются участники chris@contoso.com и michelle@contoso.com в группу Microsoft 365 с именем Legal Department.
Пример 2
$users= Get-User -ResultSize unlimited | where {$_.Department -eq "Marketing" -AND $_.RecipientType -eq "UserMailbox"}
Add-UnifiedGroupLinks -Identity Marketing -LinkType members -Links ($users.UserPrincipalName)
В этом примере показано, как добавить массовые члены в группу Microsoft 365. Почтовые ящики, где атрибут Department — "Маркетинг", добавляются в группу Microsoft 365 с именем Marketing.
Параметры
-Confirm
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.
- Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | Cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Identity
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр Identity указывает группу Microsoft 365, которую требуется изменить. Можно использовать любое значение, уникально определяющее группу Microsoft 365. Например:
- Имя
- Псевдоним
- различающееся имя (DN);
- различающееся имя (DN);
- Каноническое краткое имя
- GUID
Свойства параметров
| Тип: | UnifiedGroupIdParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Links
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр Links указывает получателей для добавления в группу Microsoft 365. Обозначьте этих получателей как членов, владельцев или подписчиков, используя параметр LinkType.
Вы можете использовать любое значение, однозначно определяющее получателя. Например:
- Имя
- Псевдоним
- различающееся имя (DN);
- различающееся имя (DN);
- Каноническое краткое имя
- GUID
Update Если значения содержат пробелы или по каким-либо другим причинам требуют применения кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".
Этот параметр необходимо использовать вместе с параметром LinkType. Это означает, что указанные получатели получают одну и ту же роль в группе Microsoft 365 (нельзя добавлять получателей с разными ролями в одной команде).
Примечание. С помощью этого командлета владельцами группы могут быть только члены группы. Добавьте пользователей в качестве участников, прежде чем добавлять их в качестве владельцев. Это ограничение не применяется на порталах веб-управления, на которых можно добавлять в качестве владельцев групп, не являющихся участниками. Гостевые пользователи никогда не могут быть владельцами групп.
Свойства параметров
| Тип: | RecipientIdParameter[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-LinkType
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр LinkType указывает роль получателя в группе Microsoft 365, которую вы хотите добавить. Допустимые значения:
- Участники: участие в беседах, создание каналов Teams, совместная работа над файлами и редактирование подключенного сайта SharePoint.
- Владельцы: добавление или удаление участников, удаление бесед, изменение параметров группы, удаление команды и полный контроль над подключенным сайтом SharePoint. У группы должно быть не менее одного владельца.
- Подписчики: существующие участники группы, которые получают уведомления о беседах и событиях календаря от группы. Все подписчики являются членами группы, но все участники не обязательно являются подписчиками (в зависимости от значения свойства AutoSubscribeNewMembers группы и времени добавления участника).
Этот параметр необходимо использовать вместе с параметром Links.
Примечание. С помощью этого командлета владельцами группы могут быть только члены группы. Добавьте пользователей в качестве участников, прежде чем добавлять их в качестве владельцев. Это ограничение не применяется на порталах веб-управления, на которых можно добавлять в качестве владельцев групп, не являющихся участниками. Гостевые пользователи никогда не могут быть владельцами групп.
Свойства параметров
| Тип: | LinkType |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | Wi |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.