Set-VivaInsightsSettings

  • リファレンス
モジュール:
ExchangePowerShell
適用対象:
Exchange Online

このコマンドレットは、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