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 Insightsuser@contoso.com中的反射功能的启用状态。

示例 2

Get-VivaModuleFeatureEnablement -ModuleId VivaInsights -FeatureId Reflection -Identity group@contoso.com

本示例返回组Viva Insightsgroup@contoso.com中的反射功能的启用状态。

示例 3

Get-VivaModuleFeatureEnablement -ModuleId VivaInsights -FeatureId Reflection -Identity user@contoso.com -Detailed

此示例返回用户Viva Insightsuser@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 地址 (电子邮件地址。

支持启用邮件Microsoft Entra组

参数属性

类型: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