Set-VivaInsightsSettings

モジュール:
Exchange PowerShell

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

例

例 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

機能パラメーターは、ユーザーに対して Microsoft Teams の Microsoft Viva Insights の機能を指定します。 有効な値は次のとおりです。

  • Headspace: Headspace のすべての機能を表します。
  • 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」を参照してください。