Get-VivaInsightsSettings
此 Cmdlet 僅適用於 Exchange Online PowerShell 模組。 如需詳細資訊，請參閱關於 Exchange Online PowerShell 模組。
注意：此 Cmdlet 僅適用於模組的 2.0.5 版或更新版本。
使用 Get-VivaInsightsSettings Cmdlet 檢查使用者是否可以在 Microsoft Teams 中存取 Microsoft Viva Insights 中的功能。 只有擁有佈建 Exchange Online 信箱的使用者才能存取 Teams 中的 Viva Insights 應用程式內的功能。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
Get-VivaInsightsSettings
-Identity <String>
[-Feature <String>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Description
這個 Cmdlet 需要 .NET Framework 4.7.2 或更新版本。
若要執行此 Cmdlet，您必須是目的地組織中下列其中一個目錄角色群組的成員：
- 全域管理員
- Exchange 系統管理員
- Teams 系統管理員
若要深入了解 Microsoft Entra ID 中的系統管理員角色權限，請參閱角色範本識別碼。
重要事項
Microsoft 強烈提倡最低權限原則。 僅為帳戶分配執行任務所需的最低權限有助於降低安全風險並加強組織的整體保護。 全域系統管理員是具有高度權限的角色，您通常會將其限制為緊急情況，或當您無法使用其他角色時。
範例
範例 1
Get-VivaInsightsSettings -Identity roy@contoso.onmicrosoft.com
UserId : roy@contoso.onmicrosoft.com
IsInsightsHeadspaceEnabled : True
此範例顯示使用者roy@contoso.onmicrosoft.com在 Microsoft Teams 中 Microsoft Viva Insights 的設定。 命令的輸出顯示 Headspace 的功能可供 Roy 使用。
參數
-Feature
適用：Exchange Online
[功能] 參數會依指定的 Microsoft Viva Insights 功能篩選結果。 有效值為：
- 頂空：代表頂空的所有功能。
- 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。