Get-VivaInsightsSettings
此 cmdlet 僅在 Exchange Online PowerShell 模組中提供。 欲了解更多資訊，請參閱「關於 Exchange Online PowerShell 模組」。
注意：此指令小程式僅在模組的 2.0.5 或更新版本中提供。
使用 Get-VivaInsightsSettings 指令小說檢查使用者是否能存取 Microsoft Teams 中Microsoft Viva Insights的功能。 只有已配置 Exchange Online 郵箱的使用者，才能在 Teams 的 Viva Insights 應用程式中存取功能。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
Get-VivaInsightsSettings
-Identity <String>
[-Feature <String>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Description
此指令檔需要 .NET Framework 4.7.2 或更新版本。
要執行此指令，您需要成為目標組織中下列目錄角色群組之一的成員：
- 全域管理員
- Exchange 系統管理員
- Teams 系統管理員
欲了解更多關於 Microsoft Entra ID 中管理員角色權限的資訊，請參閱角色範本 ID。
重要事項
Microsoft 強烈主張最小權限原則。 僅分配執行任務所需的最低權限，有助於降低安全風險並強化組織整體防護。 全域管理員是一個高度特權的角色，通常只在緊急情境或無法使用其他角色時使用。
範例
範例 1
Get-VivaInsightsSettings -Identity roy@contoso.onmicrosoft.com
UserId : roy@contoso.onmicrosoft.com
IsInsightsHeadspaceEnabled : True
此範例展示了 Microsoft Teams 中 為使用者roy@contoso.onmicrosoft.com設定 Microsoft Viva Insights 的樣貌。 指令輸出顯示 Roy 可以使用 Headspace 的功能。
參數
-Feature
適用：Exchange Online
功能參數會依據指定的 Microsoft Viva Insights 功能過濾結果。 有效值為：
- Headspace：代表 Headspace 的所有功能。
- MeetingEffectivenessSurvey：此數值僅在模組 2.0.6-Preview2 版本中作為私有預覽的一部分提供。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用：Exchange Online
Identity 參數指定你想查看的使用者。 你可以透過使用者主體名稱來識別使用者， (UPN) (roy@contoso.onmicrosoft.com 例如) 。
注意：Identity 參數的值$null或不存在的值，會回傳 所有 物件，就像你執行 Get- 指令時沒有 Identity 參數一樣。 請確認 Identity 參數的值清單是否準確，且不包含不存在的 $null 值。
參數屬性
| 類型: | 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。