Update-ComplianceCaseMember
此 cmdlet 仅在安全与合规中心 PowerShell 内可用。 有关更多信息,请参见 安全与合规中心 PowerShell。
使用 Update-ComplianceCaseMember cmdlet 替换Microsoft Purview 合规门户中电子数据展示事例的所有成员。 若要添加或删除现有成员,请使用 Add-ComplianceCaseMember 和 Remove-ComplianceCaseMember cmdlet。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
Default (默认值)
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。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Confirm
适用:安全 & 合规性
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。
- 破坏性 cmdlet(例如 Remove-* cmdlets)内置有暂停,可强制要求先确认命令,然后再继续操作。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:
-Confirm:$false。 - 其他大多数 cmdlet(例如 New-* 和 Set-* cmdlet)都没有内置暂停。 对于这些 cmdlet,指定不含值的 Confirm 开关会引入暂停,从而强制要求你先确认命令,然后再继续操作。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Members
适用:安全 & 合规性
Members 参数指定替换当前电子数据展示事例成员的用户。 可以使用任何能够唯一标识该用户的值。 例如:
- 名称
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- GUID
Update 如果值中有空格或需要使用双引号,请使用以下语法:"Value1","Value2",..."ValueN"。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-WhatIf
适用:安全 & 合规性
WhatIf 开关在安全与合规 PowerShell 中不起作用。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。