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