Get-VivaModuleFeatureEnablement
此 cmdlet 仅在 Exchange Online PowerShell 模块 3.2.0 或更高版本中可用。 有关详细信息,请参阅关于 Exchange Online PowerShell 模块。
使用 Get-VivaModuleFeatureEnablement cmdlet 查看是否为特定用户或组启用了 Viva 模块中的功能。 是否启用该功能称为该功能的“启用状态”。 此 cmdlet 返回的启用状态基于管理员设置的访问策略。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
Default (默认值)
Get-VivaModuleFeatureEnablement
-FeatureId <String>
-Identity <String>
-ModuleId <String>
[-Detailed]
[-ResultSize <Unlimited>]
[<CommonParameters>]
说明
使用 Get-VivaModuleFeatureEnablement cmdlet 查看是否为特定用户或组启用了 Viva 模块中的功能。
需要使用 Connect-ExchangeOnline cmdlet 进行身份验证。
此 cmdlet 需要 .NET Framework 4.7.2 或更高版本。
目前,你需要是全局管理员角色的成员才能运行此 cmdlet。
若要详细了解 Microsoft Entra ID 中的管理员角色权限,请参阅角色模板 ID。
重要
Microsoft强烈主张最低特权原则。 仅向帐户分配执行其任务所需的最低权限有助于降低安全风险,并增强组织的整体保护。 全局管理员是一种高特权角色,通常限制在紧急情况下或无法使用其他角色时使用。
示例
示例 1
Get-VivaModuleFeatureEnablement -ModuleId VivaInsights -FeatureId Reflection -Identity user@contoso.com
本示例为用户返回 Viva Insights user@contoso.com 中反射功能的启用状态。
示例 2
Get-VivaModuleFeatureEnablement -ModuleId VivaInsights -FeatureId Reflection -Identity group@contoso.com
本示例返回组的 Viva Insights group@contoso.com 中反射功能的启用状态。
示例 3
Get-VivaModuleFeatureEnablement -ModuleId VivaInsights -FeatureId Reflection -Identity user@contoso.com -Detailed
本示例为用户返回 Viva Insights user@contoso.com 中反射功能的启用状态。 响应得到增强,以提供有关驱动功能启用状态的策略的其他信息
参数
-Detailed
适用:Exchange Online
注意:此参数在模块版本 3.8.1-Preview1 或更高版本中可用。
“详细”开关通过提供更全面的信息来增强命令的输出。 不必为此开关指定值。
此开关返回详细的见解,包括相关策略及其有效性。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-FeatureId
适用:Exchange Online
FeatureId 参数指定 Viva 模块中的功能。
若要查看有关 Viva 模块中支持功能访问控制的功能的详细信息,请参阅 Get-VivaModuleFeature cmdlet。 Get-VivaModuleFeature cmdlet 提供的详细信息包括功能标识符。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Identity
适用:Exchange Online
Identity 参数指定要查看其功能启用状态的组) 的用户主体名称 (UPN) 或 SMTP 地址 (电子邮件地址。
警告:identity 参数的值$null或不存在的值将返回 所有 对象,就像在没有 Identity 参数的情况下运行 Get- 命令一样。 验证 Identity 参数的任何值列表是否准确且不包含不存在$null值。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-ModuleId
适用:Exchange Online
ModuleId 参数指定 Viva 模块。
参数属性
| 类型: | 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 |
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。