Get-VivaModuleFeatureEnablement
此指令小程式僅在 Exchange Online PowerShell 模組 3.2.0 版本或更新版本中提供。 欲了解更多資訊，請參閱「關於 Exchange Online PowerShell 模組」。
使用 Get-VivaModuleFeatureEnablement cmdlet 查看 Viva 模組中某功能是否為特定使用者或群組啟用。 功能是否啟用稱為該功能的「啟用狀態」。 此指令小程式回傳的啟用狀態是基於管理員設定的存取政策。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
Get-VivaModuleFeatureEnablement
-FeatureId <String>
-Identity <String>
-ModuleId <String>
[-Detailed]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Description
使用 Get-VivaModuleFeatureEnablement cmdlet 查看 Viva 模組中某功能是否為特定使用者或群組啟用。
你需要使用 Connect-ExchangeOnline cmdlet 來認證。
此指令檔需要 .NET Framework 4.7.2 或更新版本。
目前，你需要是全球管理員角色的成員才能執行這個指令小程式。
欲了解更多關於 Microsoft Entra ID 中管理員角色權限的資訊，請參閱角色範本 ID。
重要事項
Microsoft 強烈主張最小權限原則。 僅分配執行任務所需的最低權限，有助於降低安全風險並強化組織整體防護。 全域管理員是一個高度特權的角色，通常只在緊急情境或無法使用其他角色時使用。
範例
範例 1
Get-VivaModuleFeatureEnablement -ModuleId VivaInsights -FeatureId Reflection -Identity user@contoso.com
此範例會回傳 Viva Insights 中 Reflection 功能的啟用狀態給使用者 user@contoso.com 。
範例 2
Get-VivaModuleFeatureEnablement -ModuleId VivaInsights -FeatureId Reflection -Identity group@contoso.com
此範例回傳了 Viva Insights 中 Reflection 功能對該 group@contoso.com 團隊的啟用狀態。
範例 3
Get-VivaModuleFeatureEnablement -ModuleId VivaInsights -FeatureId Reflection -Identity user@contoso.com -Detailed
此範例會回傳 Viva Insights 中 Reflection 功能的啟用狀態給使用者 user@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 指令碼。 Get-VivaModuleFeature 指令匣提供的細節包含功能識別碼。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用：Exchange Online
Identity 參數指定使用者主體名稱 (使用者的 UPN) ，或您想查看功能啟用狀態的群組的 SMTP 地址 (電子郵件地址) 。
注意：Identity 參數的值$null或不存在的值，會回傳 所有 物件，就像你執行 Get- 指令時沒有 Identity 參數一樣。 請確認 Identity 參數的值清單是否準確，且不包含不存在的 $null 值。
參數屬性
| 類型: | 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。