Remove-UnifiedGroupLinks
此 cmdlet 仅在基于云的服务中可用。
使用 Remove-UnifiedGroupLinks cmdlet 从基于云的组织中的Microsoft 365 组中删除成员、所有者和订阅者。 若要添加成员、所有者和订阅者,请使用 Add-UnifiedGroupLinks cmdlet。 若要修改 Microsoft 365 组 的其他属性,请使用 Set-UnifiedGroup cmdlet。
注意:如果使用基于证书的身份验证进行连接,则不能使用此 cmdlet 修改 Microsoft 365 组成员、所有者或订阅者, (也称为对无人参与脚本) 或 Azure 托管标识的 CBA 或仅限应用的身份验证。 可以改为使用 Microsoft Graph。 有关详细信息,请参阅 组资源类型。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
Remove-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
Remove-UnifiedGroupLinks -Identity "Legal Department" -LinkType Members -Links laura@contoso.com,julia@contoso.com
此示例从名为“法律部门”的 Microsoft 365 组中删除成员 laura@contoso.com 和 julia@contoso.com 。
参数
-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
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 属性值以及何时) 添加成员。
必须将此参数与 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 |