Set-VivaInsightsSettings
このコマンドレットは、Exchange Online PowerShell モジュールでのみ使用できます。 詳細については、「Exchange Online PowerShell モジュールについて」を参照してください。
注: このコマンドレットは、バージョン 2.0.5 以降のモジュールでのみ使用できます。
Set-VivaInsightsSettings コマンドレットを使用して、Viva Insightsの機能へのユーザー アクセスを制御します。 プロビジョニングされたExchange Online メールボックスを持つユーザーのみが、Teams のViva Insights アプリ内の機能にアクセスできます。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Set-VivaInsightsSettings
-Identity <String>
-Enabled <Boolean>
-Feature <String>
[-ResultSize <Unlimited>]
[<CommonParameters>] 説明
このコマンドレットには、.NET Framework 4.7.2 以降が必要です。 このコマンドレットを実行するには、移行先組織の次のいずれかのディレクトリ ロール グループのメンバーである必要があります。
- グローバル管理者
- Exchange 管理者
- Teams 管理者
Azure Active Directory での管理者ロールのアクセス許可の詳細については、「 ロール テンプレート ID」を参照してください。
例
例 1
Set-VivaInsightsSettings -Identity roy@contoso.onmicrosoft.com -Enabled $false -Feature headspace次の使用例は、指定したユーザーの Microsoft Teams のMicrosoft Viva Insightsのすべての Headspace 機能へのアクセスを無効にします。
パラメーター
-Enabled
Enabled パラメーターは、ユーザーの Microsoft Teams のMicrosoft Viva Insightsの特定の機能へのアクセスを有効または無効にします。 有効な値は次のとおりです。
- $true: Microsoft Teams のMicrosoft Viva Insightsで指定された機能がユーザーに対して有効になります。
- $false: Microsoft Teams のMicrosoft Viva Insightsで指定された機能は、ユーザーに対して無効になります。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Feature
Feature パラメーターは、ユーザーの Microsoft Teams でのMicrosoft Viva Insightsの機能を指定します。 有効な値は次のとおりです。
- ヘッドスペース: ヘッドスペースのすべての機能を表します。
- MeetingEffectivenessSurvey: この値は、プライベート プレビューの一部としてモジュールのバージョン 2.0.6-Preview2 でのみ使用できます。
| Type: | String |
| Accepted values: | headspace |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Identity
Identity パラメーターは、変更するユーザーを指定します。 ユーザーを識別するには、ユーザー プリンシパル名 (UPN) を使用します (例: roy@contoso.onmicrosoft.com)。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ResultSize
このパラメーターは、Microsoft の内部使用のために予約されています。
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |