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。