Get-VivaModuleFeaturePolicy

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

使用 Get-VivaModuleFeaturePolicy cmdlet 在 Viva Viva 模块中查看指定功能的访问策略。 策略用于限制或授予特定用户、组或整个租户对指定功能的访问权限。 此 cmdlet 提供有关策略的详细信息,包括策略的标识符、名称和创建日期。 cmdlet 可以根据 MemberId 筛选策略,使管理员能够查看特定于特定用户或组的策略。

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

语法

Get-VivaModuleFeaturePolicy
   -FeatureId <String>
   -ModuleId <String>
   [[-PolicyId] <String>]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]
Get-VivaModuleFeaturePolicy
   -ModuleId <String>
   [[-FeatureId] <String>]
   [[-MemberIds] <String[]>]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

说明

使用 Get-VivaModuleFeaturePolicy cmdlet 在 Viva Viva 模块中查看指定功能的访问策略。

可以在 Viva Viva 模块中查看指定功能的所有策略。 若要查看特定策略,可以包括 PolicyId 参数。

cmdlet 可以根据 MemberId 筛选策略,使管理员能够查看特定于特定用户或组的策略。

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

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

目前,你需要是全局管理员角色的成员或已在功能级别分配的角色才能运行此 cmdlet。

若要详细了解在功能级别分配的角色,请参阅 可用于功能访问管理的功能

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

重要

Microsoft 建议使用权限最少的角色。 使用权限较低的帐户有助于提高组织的安全性。 全局管理员是一个权限很高的角色,应仅限于在无法使用现有角色的紧急情况下使用。

示例

示例 1

Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection

此示例返回有关Viva Insights中为反射功能添加的所有策略的详细信息。

示例 2

Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b

此示例返回有关为 Viva Insights 中的反射功能添加的特定策略的详细信息。

示例 3

Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -MemberIds user1@contoso.com

此示例返回有关Viva Insights中反射功能的策略的详细信息,这些策略通过电子邮件 user1@contoso.com应用于用户。

示例 4

Get-VivaModuleFeaturePolicy -ModuleId * -FeatureId * -MemberIds user1@contoso.com,group1@contoso.com

此示例返回有关所有Viva模块中所有功能的策略的详细信息,这些模块使用电子邮件user1@contoso.com应用于用户,以及包含电子邮件 group1@contoso.com的组。

参数

-FeatureId

FeatureId 参数指定要查看其策略的 Viva 模块中的功能。

若要查看有关支持功能访问控制的Viva模块中的功能的详细信息,请参阅 Get-VivaModuleFeature cmdlet。 Get-VivaModuleFeature cmdlet 提供的详细信息包括功能标识符。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False
适用于:Exchange Online

-MemberIds

MemberIds 参数指定要在 Viva 模块中查看功能策略的特定用户或组。

最多可以提供三个成员 ID。 使用 * 字符指定所有模块或功能。

类型:String[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False
适用于:Exchange Online

-ModuleId

ModuleId 参数指定要查看的功能策略的 Viva 模块。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False
适用于:Exchange Online

-PolicyId

PolicyId 参数为要查看的 Viva 模块中的功能指定特定策略。

若要查看有关Viva模块中某个功能的所有策略的详细信息,请运行此 cmdlet 而不使用 PolicyId 参数。 这些详细信息包括Viva模块中某个功能的所有策略的标识符。

类型:String
Position:Positional
默认值:None
必需:False
接受管道输入:False
接受通配符:False
适用于:Exchange Online

-ResultSize

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

类型:Microsoft.Exchange.Management.RestApiClient.Unlimited`1[System.UInt32]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False
适用于:Exchange Online