Get-VivaModuleFeaturePolicy
此 Cmdlet 僅適用於 Exchange Online PowerShell 模組版本 3.2.0 或更新版本。 如需詳細資訊,請參閱關於 Exchange Online PowerShell 模組。
使用 Get-VivaModuleFeaturePolicy Cmdlet 來檢視 Viva 中 Viva 模組中指定功能的存取原則。 原則可用來限制或授與特定使用者、群組或整個租用戶對指定功能的存取權。 此 Cmdlet 提供原則的詳細資料,包括原則的識別碼、名稱和建立日期。 Cmdlet 可以根據 MemberIds 篩選原則,允許系統管理員查看特定於特定使用者或群組的原則。
如需下方<語法>一節中參數集的詳細資訊,請參閱 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 可以根據 MemberIds 篩選原則,允許系統管理員查看特定於特定使用者或群組的原則。
您必須使用 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 模組中功能原則的特定使用者或群組。
您最多可以提供三個成員識別碼。 使用 * 字元指定所有模組或功能。
參數屬性
| 類型: | 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。