Set-MyAnalyticsFeatureConfig

このコマンドレットは、Exchange Online PowerShell モジュールでのみ使用できます。 詳細については、「Exchange Online PowerShell モジュールについて」を参照してください。

Set-MyAnalyticsFeatureConfig コマンドレットを使用して、指定されたユーザーの MyAnalytics の可用性と機能を構成します。

: このコマンドレットは、Set-UserAnalyticsConfig コマンドレットを置き換えます。

以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

Default (既定)

Set-MyAnalyticsFeatureConfig
    -Identity <String>
    [-Feature <String>]
    [-IsEnabled <Boolean>]
    [-PrivacyMode <String>]
    [-ResultSize <Unlimited>]
    [<CommonParameters>]

説明

このコマンドレットには、.NET Framework 4.7.2 以降が必要です。

このコマンドレットを実行するには、宛先組織内の次のディレクトリ役割グループのいずれかのメンバーである必要があります organization:

  • グローバル管理者
  • Exchange 管理者
  • Insights 管理者

Microsoft Entra ID の管理者ロールのアクセス許可の詳細については、「ロール テンプレートの ID」を参照してください。

重要

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

例 1

Set-MyAnalyticsFeatureConfig -Identity vikram@contoso.com -PrivacyMode opt-in

この例では、MyAnalytics とすべての機能を Vikram で利用できるようになります。

例 2

Set-MyAnalyticsFeatureConfig -Identity swathy@contoso.com -PrivacyMode opt-in -Feature digest-email -IsEnabled $false

この例では、MyAnalytics を Swathy で使用できるようになりますが、ダイジェスト メール機能を無効にします。

例 3

Set-MyAnalyticsFeatureConfig -Identity akshath@contoso.com -Feature digest-email -IsEnabled $false

この例では、Akshath のダイジェスト メール機能を無効にします。

パラメーター

-Feature

適用対象: Exchange Online

Feature パラメーターは、ユーザーに対して有効または無効にする MyAnalytics 機能を指定します。 有効な値は次のとおりです。

  • all (これが既定値です)
  • アドイン
  • ダッシュボード
  • digest-email

このパラメーターで指定された機能を実際に有効または無効にするには、同じコマンドで IsEnabled パラメーターを使用します。

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

型:String
規定値:None
指定可能な値:dashboard, add-in, digest-email, all
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Identity

適用対象: Exchange Online

ID パラメーターは、表示するユーザーを指定します。 ユーザーはメール アドレスで識別します。

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

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-IsEnabled

適用対象: Exchange Online

IsEnabled パラメーターは、Feature パラメーターによって指定された機能を有効または無効にするかどうかを指定します。 有効な値は次のとおりです。

  • $true: 指定した機能が有効になっています。
  • $false: 指定された機能は無効になっています。

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

型:Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-PrivacyMode

適用対象: Exchange Online

PrivacyMode パラメーターは、指定されたユーザーに対して MyAnalytics を有効にするか無効にするかを指定します。 有効な値は次のとおりです。

-opt-in: MyAnalytics はユーザーに対して有効になっています。 機能パラメーターと IsEnabled パラメーターを使用して、特定の MyAnalytics 機能を有効または無効にします。 -opt-out: MyAnalytics はユーザーに対して無効になっています。

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

型:String
規定値:None
指定可能な値:opt-in, opt-out
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値: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」を参照してください。