Поделиться через


Add-UnifiedGroupLinks

Этот командлет доступен только в облачной службе.

Используйте командлет Add-UnifiedGroupLinks, чтобы добавить участников, владельцев и подписчиков в Группы Microsoft 365 в облачной организации. Чтобы удалить участников, владельцев и подписчиков, используйте командлет Remove-UnifiedGroupLinks. Чтобы изменить другие свойства Группы Microsoft 365, используйте командлет Set-UnifiedGroup.

Примечание. Этот командлет нельзя использовать для изменения членов, владельцев или подписчиков группы Microsoft 365, если вы подключаетесь с помощью проверки подлинности на основе сертификата (также известной как CBA или проверка подлинности только для приложений для автоматических сценариев) или управляемого удостоверения Azure. Вместо этого вы можете использовать Microsoft Graph. Дополнительные сведения см. в разделе Тип ресурса группы.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

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

Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.

  • Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
  • Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Identity

Параметр Identity указывает группу Microsoft 365, которую требуется изменить. Можно использовать любое значение, уникально определяющее группу Microsoft 365. Например:

  • Имя
  • Псевдоним
  • различающееся имя (DN);
  • различающееся имя (DN);
  • Каноническое краткое имя
  • GUID
Type:UnifiedGroupIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

Параметр Links указывает получателей для добавления в группу Microsoft 365. Укажите, являются ли эти получатели участниками, владельцами или подписчиками, с помощью параметра LinkType.

Вы можете использовать любое значение, однозначно определяющее получателя. Например:

  • Имя
  • Псевдоним
  • различающееся имя (DN);
  • различающееся имя (DN);
  • Каноническое краткое имя
  • GUID

Update Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".

Этот параметр необходимо использовать вместе с параметром LinkType. Это означает, что все указанные получатели будут получать одну и ту же роль в группе Microsoft 365 (нельзя добавлять получателей с разными ролями в одной команде).

Type:RecipientIdParameter[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-LinkType

Параметр LinkType указывает роль получателя в группе Microsoft 365, которую вы хотите добавить. Допустимые значения:

  • Участники: участие в беседах, создание каналов Teams, совместная работа над файлами и редактирование подключенного сайта SharePoint.
  • Владельцы: добавление или удаление участников, удаление бесед, изменение параметров группы, удаление команды и полный контроль над подключенным сайтом SharePoint. У группы должно быть не менее одного владельца.
  • Подписчики: участники, получающие уведомления о беседах и событиях календаря из группы. Все подписчики являются членами группы, но все участники не обязательно являются подписчиками (в зависимости от значения свойства AutoSubscribeNewMembers группы и времени добавления участника).

В PowerShell любой владелец или подписчик, которого вы хотите добавить в группу, также должен быть участником.

Этот параметр необходимо использовать вместе с параметром LinkType.

Type:LinkType
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-WhatIf

Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection