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 с именем юридического отдела.
Пример 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. Почтовые ящики, в которых в качестве атрибута подразделения указан "Маркетинг", добавляются в группу Microsoft 365 с именем "Маркетинг".
Параметры
-Confirm
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. То, как этот переключатель влияет на командлет, зависит от того, требует ли командлет подтверждения перед продолжением.
- Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание параметра Confirm без значения приводит к паузе, которая вынуждает вас подтвердить команду перед продолжением.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | 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 |
| Значение по умолчанию: | 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[] |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-LinkType
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр LinkType указывает роль получателя в группе Microsoft 365, которую нужно добавить. Допустимые значения:
- Участники: участие в беседах, создание каналов Teams, совместная работа над файлами и редактирование подключенного сайта SharePoint.
- Владельцы: добавление или удаление участников, удаление бесед, изменение параметров команды, удаление команды и полный доступ к подключенному сайту SharePoint. У группы должно быть не менее одного владельца.
- Подписчики: существующие участники группы, получающие уведомления о беседах и событиях календаря из группы. Все подписчики являются членами группы, но не все участники обязательно являются подписчиками (в зависимости от значения свойства AutoSubscribeNewMembers группы и времени добавления участника).
Этот параметр необходимо использовать вместе с параметром Links.
Примечание. При использовании этого командлета только участники группы могут быть ее владельцами. Прежде чем добавлять пользователей в качестве владельцев, добавьте их в качестве участников. Это ограничение не применяется на веб-порталах управления, где вы можете добавлять посторонних пользователей в качестве владельцев группы. Гостевые пользователи никогда не могут быть владельцами группы.
Свойства параметров
| Тип: | LinkType |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-WhatIf
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Переключатель WhatIf показывает, что команда делает без каких-либо изменений. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | 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.