Get-VivaInsightsSettings
このコマンドレットは、Exchange Online PowerShell モジュールでのみ使用できます。 詳細については、「Exchange Online PowerShell モジュールについて」を参照してください。
注: このコマンドレットは、バージョン 2.0.5 以降のモジュールでのみ使用できます。
Get-VivaInsightsSettings コマンドレットを使用して、ユーザーがMicrosoft TeamsのMicrosoft Viva Insightsの機能にアクセスできるかどうかをチェックします。 プロビジョニングされたExchange Online メールボックスを持つユーザーのみが、Teams のViva Insights アプリ内の機能にアクセスできます。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
Get-VivaInsightsSettings
-Identity <String>
[-Feature <String>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
説明
このコマンドレットには、.NET Framework 4.7.2 以降が必要です。
このコマンドレットを実行するには、移行先のorganizationで次のいずれかのディレクトリ ロール グループのメンバーである必要があります。
- グローバル管理者
- Exchange 管理者
- Teams 管理者
Microsoft Entra IDでの管理者ロールのアクセス許可の詳細については、「ロール テンプレート ID」を参照してください。
重要
Microsoft では、最小限の特権の原則を強くお勧めします。 アカウントにタスクを実行するために必要な最小限のアクセス許可のみを割り当てることは、セキュリティ リスクを軽減し、organizationの全体的な保護を強化するのに役立ちます。 グローバル管理者は、通常、緊急シナリオや別のロールを使用できない場合に制限する高い特権を持つロールです。
例
例 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
Feature パラメーターは、指定したMicrosoft Viva Insights機能によって結果をフィルター処理します。 有効な値は次のとおりです。
- ヘッドスペース: ヘッドスペースのすべての機能を表します。
- MeetingEffectivenessSurvey: この値は、プライベート プレビューの一部としてモジュールのバージョン 2.0.6-Preview2 でのみ使用できます。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | 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」を参照してください。