Update-VivaModuleFeaturePolicy

此 cmdlet 仅在 Exchange Online PowerShell 模块 v3.2.0 或更高版本中可用。 有关详细信息,请参阅关于 Exchange Online PowerShell 模块

注意:此 cmdlet 是当前处于关闭的专用预览版中的功能的一部分。 除非你的组织是个人预览版的成员,否则 cmdlet 将不起作用。

使用 Update-VivaModuleFeaturePolicy cmdlet 更新 Viva 模块中某个功能的访问策略。 在确定是否启用某个功能时,特定用户或组的最严格策略优先。

有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法

语法

Update-VivaModuleFeaturePolicy
      -FeatureId <String>
      -ModuleId <String>
      -PolicyId <String>
      [-Confirm]
      [-IsFeatureEnabled <Boolean>]
      [-GroupIds <String[]>]
      [-Everyone <Boolean>]
      [-Name <String>]
      [-ResultSize <Unlimited>]
      [-UserIds <String[]>]
      [-WhatIf]
      [<CommonParameters>]

说明

使用 Update-VivaModuleFeaturePolicy cmdlet 更新 Viva 模块中某个功能的访问策略。

此 cmdlet 更新指定的策略的属性。 这些属性包括:

  • 策略名称 (Name 参数) 。
  • 策略是否启用 IsFeatureEnabled 参数 (功能) 。
  • 策略应用于 (UserIds 和 GroupIds 参数或 Everyone 参数) 。

可以彼此独立地更新这些属性。 例如,如果指定 Name 参数但不指定 IsFeatureEnabled 参数,则会更新策略的名称,但策略是否启用该功能保持不变。

重要提示:为 UserId 和/或 GroupIds 参数或 Everyone 参数指定的值 将覆盖 任何现有用户或组。 若要保留现有用户和组,需要指定要添加的这些现有用户或组 以及 任何其他用户或组。 在 命令中不包括现有用户或组会有效地从策略中删除这些特定用户或组。 有关详细信息,请参阅示例。

需要使用 Connect-ExchangeOnline cmdlet 进行身份验证。

此 cmdlet 需要 .NET Framework 4.7.2 或更高版本。

目前,你需要是全局管理员角色的成员才能运行此 cmdlet。

若要详细了解 Azure Active Directory 中的管理员角色权限,请参阅 角色模板 ID

示例

示例 1

Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b1 -Name NewPolicyName -IsFeatureEnabled $false

本示例更新指定策略的名称,使其不启用该功能。

示例 2

Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -GroupIds group1@contoso.com,group2@contoso.com

此示例更新指定策略应用于的人员。 该策略现在 仅适用于 指定的组,覆盖用于应用策略的用户和组。

示例 3

Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -UserIds user1@contoso.com,user2@contoso.com

此示例更新指定策略应用于的人员。 策略现在 仅适用于 指定的用户,覆盖用于应用策略的用户和组。

示例 4

Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -Name NewPolicyName -IsFeatureEnabled $true -GroupIds group1@contoso.com -UserIds user1@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

-Everyone

Everyone 参数指定更新的策略应用于组织中的所有用户。 有效值包含:

  • $true:策略适用于所有用户。 这是此参数的唯一有用值。
  • $false:请勿使用此值。

如果不想更新应用策略的人员,请不要使用此参数。

不要将此参数与 GroupIds 或 UserIds 参数一起使用。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-FeatureId

FeatureId 参数指定要更新的策略的 Viva 模块中的功能。

若要查看有关 Viva 模块中支持功能访问控制的功能的详细信息,请使用 Get-VivaModuleFeature cmdlet。 在 cmdlet 的输出中返回 FeatureId 值。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-GroupIds

GroupIds 参数指定应用更新策略的组的电子邮件地址。 支持启用邮件的 AAD 组。 Update

如果不想更新应用策略的人员,请不要使用此参数。

为此参数或 UserIds 参数指定的值将替换任何现有组。 若要保留现有组,请将其与指定的任何新用户或组一起包含。

最多可以指定 20 个用户或组总数, (20 个用户和无组、10 个用户和 10 个组等) 。

若要将更新的策略应用于组织中的所有用户,请使用具有 值$true的 Everyone 参数。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-IsFeatureEnabled

IsFeatureEnabled 参数指定是否由更新的策略启用该功能。 有效值包含:

  • $true:该功能由策略启用。
  • $false:策略未启用此功能。

如果不想更新是否由策略启用该功能,请不要使用此参数。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ModuleId

ModuleId 参数指定要更新的策略的 Viva 模块。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Name

Name 参数指定策略的更新名称。 长度不得超过 256 个字符。 如果值中有空格,请使用双引号 (") 将此值括起来。

有效字符是英文字母、数字、逗号、句点和空格。

如果不想更新策略的名称,请不要使用此参数。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-PolicyId

PolicyId 参数指定 Viva 模块中要更新的功能的策略。

若要查看有关 Viva 模块中某个功能的策略的详细信息,请使用 Get-VivaModuleFeaturePolicy cmdlet。 在 cmdlet 的输出中返回 PolicyId 值。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ResultSize

保留此参数以供 Microsoft 内部使用。

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-UserIds

UserIds 参数指定 (应用更新策略的用户) UPN 的用户主体名称。 Update

如果不想更新应用策略的人员,请不要使用此参数。

为此参数或 GroupIds 参数指定的值将替换任何现有用户。 若要保留现有用户,请将其与指定的任何新用户或组一起包含。

最多可以指定 20 个用户或组总数, (20 个用户和无组、10 个用户和 10 个组等) 。

若要将更新的策略应用于组织中的所有用户,请使用具有 值$true的 Everyone 参数。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-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