Add-UnifiedGroupLinks

此 cmdlet 仅在基于云的服务中可用。

使用 Add-UnifiedGroupLinks cmdlet 将成员、所有者和订阅者添加到基于云的组织中Microsoft 365 组。 若要删除成员、所有者和订阅者,请使用 Remove-UnifiedGroupLinks cmdlet。 若要修改 Microsoft 365 组 的其他属性,请使用 Set-UnifiedGroup cmdlet。

注意:如果使用基于证书的身份验证进行连接,则不能使用此 cmdlet 修改 Microsoft 365 组成员、所有者或订阅者, (也称为对无人参与脚本) 或 Azure 托管标识的 CBA 或仅限应用的身份验证。 可以改为使用 Microsoft Graph。 有关详细信息,请参阅 组资源类型

有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法

语法

Add-UnifiedGroupLinks
   [-Identity] <UnifiedGroupIdParameter>
   -Links <RecipientIdParameter[]>
   -LinkType <LinkType>
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

说明

Microsoft 365 组是跨 Microsoft 365 服务可用的组对象。

您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数并未包含在分配给您的权限中,那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 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 组。 将 Department 属性为“Marketing”的邮箱添加到名为 Marketing 的 Microsoft 365 组。

参数

-Confirm

Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

  • 破坏性 cmdlet (例如,Remove-* cmdlet) 具有内置的暂停,该暂停会强制你在继续操作之前确认命令。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:-Confirm:$false
  • 大多数其他 cmdlet (例如,New-* 和 Set-* cmdlet) 没有内置暂停。 对于这些 cmdlet,指定不含值的 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)
  • 规范 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)
  • 规范 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