Set-VivaInsightsSettings
此 Cmdlet 僅適用於 Exchange Online PowerShell 模組。 如需詳細資訊，請參閱 關於 Exchange Online PowerShell 模組。
附註： 此 Cmdlet 僅適用於模組的 2.0.5 版或更新版本。
使用 Set-VivaInsightsSettings Cmdlet 來控制使用者對 Viva Insights 中功能的存取。 只有具有布建 Exchange Online 信箱的使用者才能存取 Teams 中 Viva Insights 應用程式內的功能。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
Set-VivaInsightsSettings
-Identity <String>
-Enabled <Boolean>
-Feature <String>
[-ResultSize <Unlimited>]
[<CommonParameters>]
Description
此 Cmdlet 需要 .NET Framework 4.7.2 或更新版本。
若要執行此 Cmdlet，您必須是目的地組織中下列其中一個目錄角色群組的成員：
- 全域管理員
- Exchange 系統管理員
- Teams 系統管理員
若要深入瞭解 Microsoft Entra ID 中的系統管理員角色許可權，請參閱角色範本識別碼。
重要事項
Microsoft 強烈提倡最小權限原則。 僅為帳戶指派執行其任務所需的最低權限，有助於降低安全風險並加強組織的整體保護。 全域管理員是高度許可權的角色，您通常會將其限制為緊急情況或當您無法使用其他角色時。
範例
範例 1
Set-VivaInsightsSettings -Identity roy@contoso.onmicrosoft.com -Enabled $false -Feature headspace
此範例會停用指定使用者在 Microsoft Teams 中存取 Microsoft Viva Insights 中的所有頂空功能。
參數
-Enabled
適用：Exchange Online
[已啟用] 參數可為使用者啟用或停用 Microsoft Teams 中 Microsoft Viva Insights 特定功能的存取權。 有效值為：
- $true：已為使用者啟用 Microsoft Teams 中 Microsoft Viva Insights 中的指定功能。
- $false：Microsoft Teams 中Microsoft Viva Insights中的指定功能會為使用者停用。
參數屬性
| 類型: | Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Feature
適用：Exchange Online
Feature 參數會為使用者指定 Microsoft Teams 中 Microsoft Viva Insights 的功能。 有效值為：
- 頂空：代表頂空的所有功能。
- MeetingEffectivenessSurvey：此值僅適用於模組的 2.0.6-Preview2 版，作為私人預覽的一部分。
參數屬性
| 類型: | String |
| 預設值: | None |
| 接受的值: | headspace |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用：Exchange Online
身分識別參數指定您要修改的使用者。 您可以透過使用者主體名稱 (UPN) (來識別使用者，例如 roy@contoso.onmicrosoft.com) 。
參數屬性
| 類型: | 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。