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