Get-VivaInsightsSettings

モジュール:
Exchange PowerShell

このコマンドレットは、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 では、最小限のアクセス許可の原則を強くお勧めします。 アカウントにタスクを実行するために必要な最小限のアクセス許可のみを割り当てることは、セキュリティ リスクを軽減し、組織の全体的な保護を強化するのに役立ちます。 グローバル管理者は、通常は緊急時や別のロールを使用できない場合に限定する、非常に特権のあるロールです。

例

例 1

Get-VivaInsightsSettings -Identity roy@contoso.onmicrosoft.com

UserId : roy@contoso.onmicrosoft.com
IsInsightsHeadspaceEnabled : True

この例は、ユーザー roy@contoso.onmicrosoft.comの Microsoft Teams の Microsoft Viva Insights の構成を示しています。 コマンドの出力は、Roy が Headspace の機能を使用できることを示しています。

パラメーター

-Feature

適用対象: Exchange Online

機能パラメーターは、指定した Microsoft Viva Insights 機能で結果をフィルター処理します。 有効な値は次のとおりです。

  • Headspace: Headspace のすべての機能を表します。
  • 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 など) で識別します。

注意: Identityパラメータの値$nullまたは存在しない値は、IdentityパラメータなしでGet-コマンドを実行したかのように、 すべての オブジェクトを返します。 Identity パラメーターの値のリストが正確であり、存在しない$null値が含まれていないことを確認します。

パラメーターのプロパティ

型: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」を参照してください。