Update-ComplianceCaseMember
此 cmdlet 仅在安全性 & 合规性 PowerShell 中可用。 有关详细信息,请参阅 安全性 & 合规性 PowerShell。
使用 Update-ComplianceCaseMember cmdlet 替换Microsoft Purview 合规门户中电子数据展示事例的所有成员。 若要添加或删除现有成员,请使用 Add-ComplianceCaseMember 和 Remove-ComplianceCaseMember cmdlet。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
Update-ComplianceCaseMember
[-Case] <String>
-Members <String[]>
[-Confirm]
[-WhatIf]
[<CommonParameters>]
说明
使用电子数据展示事例可以控制哪些用户可以在您的组织中创建、访问和管理合规性搜索。 使用 New-ComplianceCase cmdlet 可以创建电子数据展示事例。 创建事例的电子数据展示管理器会自动添加为此事例的成员。
用户必须是审阅者或电子数据展示管理器角色组的成员,才能添加电子数据展示事例的成员。 当电子数据展示管理器角色组的成员是电子数据展示事例的成员时,用户可以:
- 添加和删除事例成员。
- 创建和编辑与事例相关联的合规性搜索。
- 对合规性搜索结果执行合规性操作(例如,导出)。
若要在安全性 & 合规性 PowerShell 中使用此 cmdlet,需要分配权限。 有关详细信息,请参阅 Microsoft Purview 合规门户中的权限。
示例
示例 1
Update-ComplianceCaseMember -Case "Case 5150" -Members chris@contoso.com,michelle@contoso.com,laura@contoso.com,julia@contoso.com
本示例将名为 Case 5150 的电子数据展示事例的现有成员替换为新成员。
参数
-Case
Case 参数指定要修改的电子数据展示事例的名称。 如果值中有空格,请使用双引号 (") 将此值括起来。
若要查看可用的电子数据展示事例,请使用 Get-ComplianceCase cmdlet。
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-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: | Security & Compliance |
-Members
Members 参数指定将替换当前电子数据展示事例成员的用户。 可以使用任何能够唯一标识该用户的值。 例如:
- 名称
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- GUID
Update 如果值包含空格或需要引号,请使用以下语法: "Value1","Value2",..."ValueN"
。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-WhatIf
WhatIf 开关在安全 & 合规性 PowerShell 中不起作用。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |