Add-VivaModuleFeaturePolicy
此 cmdlet 仅在 Exchange Online PowerShell 模块 v3.2.0 或更高版本中可用。 有关详细信息，请参阅关于 Exchange Online PowerShell 模块。
注意：此 cmdlet 是当前处于关闭的专用预览版中的功能的一部分。 除非你的组织是个人预览版的成员，否则 cmdlet 将不起作用。
使用 Add-VivaModuleFeaturePolicy cmdlet 为 Viva 中的特定功能添加新访问策略。 策略的属性是使用 cmdlet 的各种参数定义的。 策略用于限制或授予特定用户、组或整个租户对指定功能的访问权限。 请注意，对于特定用户或组，限制性最高的策略在确定是否启用某个功能时具有优先级。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Add-VivaModuleFeaturePolicy
-FeatureId <String>
-IsFeatureEnabled <Boolean>
-ModuleId <String>
-Name <String>
[-Confirm]
[-GroupIds <String[]>]
[-UserIds <String[]>]
[-Everyone]
[-ResultSize <Unlimited>]
[-WhatIf]
[<CommonParameters>] 说明
使用 Add-VivaModuleFeaturePolicy cmdlet 为 Viva 中的特定功能添加新访问策略。
需要使用 Connect-ExchangeOnline cmdlet 进行身份验证。
此 cmdlet 需要 .NET Framework 4.7.2 或更高版本。
目前，你需要是全局管理员角色的成员才能运行此 cmdlet。
若要详细了解 Azure Active Directory 中的管理员角色权限，请参阅 角色模板 ID。
示例
示例 1
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name DisableFeatureForAll -IsFeatureEnabled $false -Everyone本示例在 Viva Insights 中添加反射功能的策略。 该策略对组织中的所有用户禁用该功能。
示例 2
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name MultipleGroups -IsFeatureEnabled $false -GroupIds group1@contoso.com,group2@contoso.com本示例在 Viva Insights 中添加反射功能的策略。 该策略对指定组中的所有用户禁用该功能。
示例 3
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name MultipleUsers -IsFeatureEnabled $false -UserIds user1@contoso.com,user2@contoso.com本示例在 Viva Insights 中添加反射功能的策略。 该策略为指定用户禁用该功能。
示例 4
Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name UsersAndGroups -IsFeatureEnabled $false -GroupIds group1@contoso.com,group2@contoso.com -UserIds user1@contoso.com,user2@contoso.com本示例在 Viva Insights 中添加反射功能的策略。 该策略为指定的用户和组成员禁用该功能。
参数
-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
“每个人”开关指定策略应用于组织中的所有用户。 不必为此开关指定值。
请勿将此开关与 GroupIds 或 UserIds 参数一起使用。
| Type: | SwitchParameter |
| 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 参数指定应用策略的组) SMTP 地址 (电子邮件地址。 支持启用邮件的 AAD 组。 Update
最多可以指定 20 个用户或组总数， (20 个用户和无组、10 个用户和 10 个组等) 。
若要将策略应用于组织中的所有用户，请使用“每个人”开关。
| 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: | True |
| 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: | 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
最多可以指定 20 个用户或组总数， (20 个用户和无组、10 个用户和 10 个组等) 。
若要将策略应用于组织中的所有用户，请使用“每个人”开关。
| 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 |