Update-VivaModuleFeaturePolicy
此 cmdlet 仅在 Exchange Online PowerShell 模块 v3.2.0 或更高版本中可用。 有关详细信息，请参阅关于 Exchange Online PowerShell 模块。
使用 Update-VivaModuleFeaturePolicy cmdlet 更新 Viva Viva 模块中的功能的访问策略。
- 如果针对该功能已存在针对整个租户的策略，则无法更新特定用户或组的策略以包含整个租户。 仅支持一个租户范围策略。
- 在确定是否启用某个功能时，分配给特定用户或组的策略优先于分配给整个租户的策略。 如果用户为某个功能分配了多个策略， (直接作为用户或组) 的成员，则应用限制性最高的策略。
- 某些功能仅支持应用于整个租户的策略，而不支持特定用户或组。 可以使用 Get-VivaModuleFeature cmdlet 引用某个功能的支持策略范围。
某些功能包括用户控件选项， (用户选择退出) 。 请参阅功能文档，了解用户控件是否可用于要为其设置策略的功能。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Default （默认值）
Update-VivaModuleFeaturePolicy
-FeatureId <String>
-ModuleId <String>
-PolicyId <String>
[-Confirm]
[-Everyone <Boolean>]
[-IsFeatureEnabled <Boolean>]
[-IsUserControlEnabled <Boolean>]
[-IsUserOptedInByDefault <Boolean>]
[-GroupIds <String[]>]
[-Name <String>]
[-ResultSize <Unlimited>]
[-UserIds <String[]>]
[-WhatIf]
[<CommonParameters>]
说明
使用 Update-VivaModuleFeaturePolicy cmdlet 更新 Viva Viva 模块中的功能的访问策略。
此 cmdlet 更新指定的策略的属性。 这些属性包括：
- 策略名称 (Name 参数) 。
- 策略是否启用 IsFeatureEnabled 参数 (功能) 。
- 策略是否 (IsUserControlEnabled 参数启用用户控制，仅适用于功能策略) 。
- 策略应用于 (UserIds 和 GroupIds 参数或 Everyone 参数) 。
可以彼此独立地更新这些属性。 例如，如果指定 Name 参数但不指定 IsFeatureEnabled 参数，则会更新策略的名称，但策略是否启用该功能保持不变。
重要提示：为 UserId 和/或 GroupIds 参数或 Everyone 参数指定的值 将覆盖 任何现有用户或组。 若要保留现有用户和组，需要指定要添加的这些现有用户或组 以及 任何其他用户或组。 在 命令中不包括现有用户或组会有效地从策略中删除这些特定用户或组。 有关详细信息，请参阅示例。
需要使用 Connect-ExchangeOnline cmdlet 进行身份验证。
此 cmdlet 需要 .NET Framework 4.7.2 或更高版本。
目前，你需要是全局管理员角色的成员或已在功能级别分配的角色才能运行此 cmdlet。
若要详细了解在功能级别分配的角色，请参阅 可用于功能访问管理的功能。
若要详细了解 Microsoft Entra ID 中的管理员角色权限，请参阅角色模板 ID。
重要
Microsoft 建议使用权限最少的角色。 使用权限较低的帐户有助于提高组织的安全性。 全局管理员是一个权限很高的角色，应仅限于在无法使用现有角色的紧急情况下使用。
示例
示例 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,57680382-61a5-4378-85ad-f72095d4e9c3 -UserIds user1@contoso.com
此示例更新指定策略的名称，使该策略启用该功能，并更新应用策略的人员。 该策略现在 仅适用于 指定的用户和组，覆盖用于应用策略的用户和组。
示例 5
Update-VivaModuleFeaturePolicy -ModuleId PeopleSkills -FeatureId ShowAISkills -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -IsFeatureEnabled $true -IsUserControlEnabled $true -IsUserOptedInByDefault $false
本示例更新 Viva Skills 中 ShowAISkills 功能的策略。 该策略为以前添加到策略的用户启用该功能，允许用户控制，并在默认情况下选择退出用户， (软禁用策略) 。
参数
-Confirm
适用：Exchange Online
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 |
-Everyone
适用：Exchange Online
Everyone 参数指定更新的策略应用于组织中的所有用户。 有效值包含:
- $true：策略适用于所有用户。 这是此参数的唯一有用值。
- $false：请勿使用此值。
如果不想更新应用策略的人员，请不要使用此参数。
不要将此参数与 GroupIds 或 UserIds 参数一起使用。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-FeatureId
适用：Exchange Online
FeatureId 参数指定要更新的策略的 Viva 模块中的功能。
若要查看有关支持功能访问控制的 Viva 模块中的功能的详细信息，请使用 Get-VivaModuleFeature cmdlet。 在 cmdlet 的输出中返回 FeatureId 值。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-GroupIds
适用：Exchange Online
GroupIds 参数指定电子邮件地址或安全组对象 ID， (GUID) 应用更新策略的组。 支持已启用邮件和未启用邮件的Microsoft Entra组。 Update
如果不想更新应用策略的人员，请不要使用此参数。
为此参数或 UserIds 参数指定的值将替换任何现有组。 若要保留现有组，请将其与指定的任何新用户或组一起包含。
最多可以指定 20 个用户或组总数， (20 个用户和无组、10 个用户和 10 个组等 ) 。
若要将更新的策略应用于组织中的所有用户，请使用具有 值$true的 Everyone 参数。
注意：在模块的 v3.5.1-Preview2 或更高版本中，此参数支持安全组对象 ID (GUID) 。 以前版本的模块仅接受此参数的电子邮件地址。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-IsFeatureEnabled
适用：Exchange Online
IsFeatureEnabled 参数指定是否由更新的策略启用该功能。 有效值包含:
- $true：该功能由策略启用。
- $false：策略未启用此功能。
如果不想更新是否由策略启用该功能，请不要使用此参数。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-IsUserControlEnabled
适用：Exchange Online
注意：此参数在模块的 3.3.0 或更高版本中可用。 如果功能支持用户控件选择退出，请确保在创建策略时设置 IsUserControlEnabled 参数。 否则，策略的用户控件使用功能的默认状态。
IsUserControlEnabled 参数指定策略是否启用用户控制。 有效值包含:
- $true：策略启用用户控制。 用户可以选择退出该功能。
- $false：策略未启用用户控制。 用户无法选择此功能。
只有允许管理员通过策略启用和禁用用户控制的功能才能使用此参数。 如果该功能不支持管理员切换用户控件，则应用默认值。 有关详细信息，请参阅功能文档。
如果不想更新策略是否启用了用户控件，请不要使用此参数。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-IsUserOptedInByDefault
适用：Exchange Online
此参数在模块的 3.8.0-Preview2 或更高版本中可用。
IsUserOptedInByDefault 参数指定策略是否默认选择加入用户。 有效值包含:
- $true：默认情况下，如果用户尚未设置首选项，则策略会选择加入。
- $false：默认情况下，如果用户尚未设置首选项，则策略会选择退出用户。
此参数是可选的，可用于替代功能元数据中设置的默认用户选择加入值。
仅当 IsUserControlEnabled 参数设置为 $true 时，才能设置此参数。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ModuleId
适用：Exchange Online
ModuleId 参数指定要更新的策略的 Viva 模块。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Name
适用：Exchange Online
Name 参数指定策略的更新名称。 长度不得超过 256 个字符。 如果值中有空格，请使用双引号 (") 将此值括起来。
有效字符是英文字母、数字、逗号、句点和空格。
如果不想更新策略的名称，请不要使用此参数。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-PolicyId
适用：Exchange Online
PolicyId 参数指定Viva模块中要更新的功能的策略。
若要查看有关Viva模块中某个功能的策略的详细信息，请使用 Get-VivaModuleFeaturePolicy cmdlet。 在 cmdlet 的输出中返回 PolicyId 值。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ResultSize
适用：Exchange Online
保留此参数以供 Microsoft 内部使用。
参数属性
| 类型: | Unlimited |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-UserIds
适用：Exchange Online
UserIds 参数指定 (应用更新策略的用户) UPN 的用户主体名称。 Update
如果不想更新应用策略的人员，请不要使用此参数。
为此参数或 GroupIds 参数指定的值将替换任何现有用户。 若要保留现有用户，请将其与指定的任何新用户或组一起包含。
最多可以指定 20 个用户或组总数， (20 个用户和无组、10 个用户和 10 个组等 ) 。
若要将更新的策略应用于组织中的所有用户，请使用具有 值$true的 Everyone 参数。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WhatIf
适用：Exchange Online
WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。
参数属性
| 类型: | 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。