共用方式為


Get-VivaModuleFeaturePolicy

此 Cmdlet 僅適用於 Exchange Online PowerShell 模組 3.2.0 版或更新版本。 如需詳細資訊,請參閱 關於 Exchange Online PowerShell 模組

使用 Get-VivaModuleFeaturePolicy Cmdlet 來檢視 Viva 中 Viva 模組中指定功能的存取原則。 原則可用來限制或授與特定使用者、群組或整個租用戶對指定功能的存取權。 此 Cmdlet 提供原則的詳細資料,包括原則的識別碼、名稱和建立日期。 Cmdlet 可以根據 MemberId 篩選原則,讓系統管理員檢視特定使用者或群組的原則。

如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法

語法

FeaturePolicy

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

FeaturePolicyWithMembers

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

Description

使用 Get-VivaModuleFeaturePolicy Cmdlet 來檢視 Viva 中 Viva 模組中指定功能的存取原則。

您可以在 Viva 中檢視 Viva 模組中指定功能的所有原則。 若要檢視特定原則,您可以包含 PolicyId 參數。

Cmdlet 可以根據 MemberId 篩選原則,讓系統管理員檢視特定使用者或群組的原則。

您必須使用 Connect-ExchangeOnline Cmdlet 來驗證。

此 Cmdlet 需要 .NET Framework 4.7.2 或更新版本。

目前,您必須是全域系統管理員角色的成員,或已在功能層級指派的角色,才能執行此 Cmdlet。

若要深入瞭解功能層級指派的角色,請參閱 功能 存取管理可用的功能

若要深入瞭解 Microsoft Entra 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

適用:Exchange Online

FeatureId 參數會指定您想要檢視其原則的 Viva 模組中的功能。

若要檢視 Viva 模組中支援功能存取控制之功能的詳細數據,請參閱 Get-VivaModuleFeature Cmdlet。 Get-VivaModuleFeature Cmdlet 所提供的詳細數據包含功能識別碼。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

FeaturePolicy
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
FeaturePolicyWithMembers
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-MemberIds

適用:Exchange Online

附註: 此參數在模組版本 3.8.1-Preview1 或更新版本中可用。

MemberIds 參數會指定您想要檢視 Viva 模組中功能原則的特定使用者或群組。

您最多可以提供三個會員 ID。 使用 * 字元來指定所有模組或特性。

參數屬性

類型:

String[]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

FeaturePolicyWithMembers
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ModuleId

適用:Exchange Online

ModuleId 參數會指定您想要檢視之功能原則的 Viva 模組。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-PolicyId

適用:Exchange Online

PolicyId 參數會指定您想要檢視之 Viva 模組中功能的特定原則。

若要檢視 Viva 模組中功能所有原則的詳細數據,請在沒有 PolicyId 參數的情況下執行此 Cmdlet。 這些詳細數據包括 Viva 模組中功能所有原則的識別碼。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

FeaturePolicy
Position:Positional
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ResultSize

適用:Exchange Online

將保留此參數供 Microsoft 內部使用。

參數屬性

類型:

Microsoft.Exchange.Management.RestApiClient.Unlimited`1[System.UInt32]

預設值: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