Set-VivaInsightsSettings
このコマンドレットは、Exchange Online PowerShell モジュールでのみ使用できます。 詳細については、「Exchange Online PowerShell モジュールについて」を参照してください。
注: このコマンドレットは、バージョン 2.0.5 以降のモジュールでのみ使用できます。
Set-VivaInsightsSettings コマンドレットを使用して、Viva Insightsの機能へのユーザー アクセスを制御します。 プロビジョニングされたExchange Online メールボックスを持つユーザーのみが、Teams のViva Insights アプリ内の機能にアクセスできます。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
Set-VivaInsightsSettings
-Identity <String>
-Enabled <Boolean>
-Feature <String>
[-ResultSize <Unlimited>]
[<CommonParameters>]
説明
このコマンドレットには、.NET Framework 4.7.2 以降が必要です。
このコマンドレットを実行するには、移行先のorganizationで次のいずれかのディレクトリ ロール グループのメンバーである必要があります。
- グローバル管理者
- Exchange 管理者
- Teams 管理者
Microsoft Entra IDでの管理者ロールのアクセス許可の詳細については、「ロール テンプレート ID」を参照してください。
重要
Microsoft では、最小限の特権の原則を強くお勧めします。 アカウントにタスクを実行するために必要な最小限のアクセス許可のみを割り当てることは、セキュリティ リスクを軽減し、organizationの全体的な保護を強化するのに役立ちます。 グローバル管理者は、通常、緊急シナリオや別のロールを使用できない場合に制限する高い特権を持つロールです。
例
例 1
Set-VivaInsightsSettings -Identity roy@contoso.onmicrosoft.com -Enabled $false -Feature headspace
次の使用例は、指定したユーザーのMicrosoft TeamsのMicrosoft Viva Insightsのすべての Headspace 機能へのアクセスを無効にします。
パラメーター
-Enabled
適用対象: Exchange Online
Enabled パラメーターは、ユーザーのMicrosoft TeamsでMicrosoft Viva Insightsの特定の機能へのアクセスを有効または無効にします。 有効な値は次のとおりです。
- $true: Microsoft TeamsのMicrosoft Viva Insightsで指定された機能がユーザーに対して有効になります。
- $false: Microsoft TeamsのMicrosoft Viva Insightsで指定された機能は、ユーザーに対して無効になります。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Feature
適用対象: Exchange Online
Feature パラメーターは、ユーザーのMicrosoft TeamsでMicrosoft Viva Insightsの機能を指定します。 有効な値は次のとおりです。
- ヘッドスペース: ヘッドスペースのすべての機能を表します。
- MeetingEffectivenessSurvey: この値は、プライベート プレビューの一部としてモジュールのバージョン 2.0.6-Preview2 でのみ使用できます。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| 指定可能な値: | headspace |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Identity
適用対象: Exchange Online
Identity パラメーターは、変更するユーザーを指定します。 ユーザーを識別するには、ユーザー プリンシパル名 (UPN) ( roy@contoso.onmicrosoft.comなど) を使用します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ResultSize
適用対象: Exchange Online
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | Unlimited |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。