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

次の方法で共有