Exchange Online PowerShell モジュールについて

Exchange Online PowerShell モジュール (2022 年以降は Exchange Online PowerShell V3 モジュールまたは EXO V3 モジュールとも呼ばれます) は、先進認証を使用し、多要素認証 (MFA) の有無にかかわらず動作して、すべての Exchange クラウド関連の PowerShell 環境に接続します。 Exchange OnlinePowerShell、Security & Compliance PowerShell、およびオンプレミス メールボックス用の組み込みセキュリティ アドオン用の PowerShell。

モジュールを使用した接続手順については、次の記事を参照してください。

• Exchange Online PowerShell への接続

  ヒント

  オンプレミス メールボックスの組み込みセキュリティ アドオンの PowerShell の接続手順は、Exchange Online PowerShell の接続手順と同じです。

• セキュリティ/コンプライアンス PowerShell に接続する

• Exchange Online PowerShell およびセキュリティ & コンプライアンス PowerShell での無人スクリプトのアプリのみの認証

• Azure マネージド ID を使用して Exchange Online PowerShell に接続する

• C# を使用して Exchange Online PowerShell に接続する

この記事の以下のセクションでは、モジュールのしくみ、モジュールをインストールしてメンテンアンスする方法、およびモジュールで使用できる最適化された Exchange Online コマンドレットについて説明します。

EXO V3 モジュールの REST API 接続

Exchange Online PowerShell とセキュリティ & コンプライアンス PowerShell は、2023 年以降、すべてのコマンドレットに REST API 接続を使用します。

REST API 接続には、PowerShellGet モジュールと PackageManagement モジュールが必要です。 詳細については、「 Windows で REST ベースの接続を行うための PowerShellGet」を参照してください。

REST API 接続のコマンドレットには、従来のコマンドレットに比べて次の利点があります。

• セキュリティの向上: 先進認証のサポートが組み込まれており、リモート PowerShell セッションに依存しません。 クライアント コンピューター上の PowerShell では、 WinRM の基本認証は必要ありません。
• 信頼性の向上: 一時的な障害は組み込みの再試行を使用するため、障害や遅延は最小限に抑えられます。 例:
  • ネットワークの遅延による障害。
  • 完了までに時間がかかる大規模なクエリが原因の遅延。
• パフォーマンスの向上: REST API 接続では、PowerShell 実行空間の設定が回避されます。

次の表は、REST API コマンドレットと、 EXO V3 モジュール内の使用できないリモート PowerShell コマンドレットおよび排他的な Get-EXO* コマンドレットの利点を比較したものです。

REST API コマンドレットはコマンドレット名が同じで、リモートの PowerShell コマンドレットと同じように動作するため、スクリプト内のコマンドレット名やパラメーターを更新する必要はありません。

Exchange Online PowerShell のいくつかのコマンドレットが、試験的な UseCustomRouting スイッチで更新されています。 このスイッチは、コマンドが必要なメールボックス サーバーに直接ルーティングし、全体的なパフォーマンスが向上する可能性があります。 UseCustomRouting スイッチを実験的に使用します。

• UseCustomRoutingSwitch を使用する場合は、メールボックスの ID に次の値のみを使用できます。

  • ユーザー プリンシパル名 (UPN)
  • 電子メール アドレス
  • メールボックス GUID

• UseCustomRouting スイッチは、次の Exchange Online PowerShell コマンドレットでのみ使用できます。

  • Get-Clutter
  • Get-FocusedInbox
  • Get-InboxRule
  • Get-MailboxAutoReplyConfiguration
  • Get-MailboxCalendarFolder
  • Get-MailboxFolderPermission
  • Get-MailboxFolderStatistics
  • Get-MailboxMessageConfiguration
  • Get-MailboxPermission
  • Get-MailboxRegionalConfiguration
  • Get-MailboxStatistics
  • Get-MobileDeviceStatistics
  • Get-UserPhoto
  • Remove-CalendarEvents
  • Set-Clutter
  • Set-FocusedInbox
  • Set-MailboxRegionalConfiguration
  • Set-UserPhoto

• Get-ConnectionInformation コマンドレットを使用して、Exchange Online PowerShell とセキュリティ & コンプライアンス PowerShell への接続に関する情報を取得します。 このコマンドレットが必要なのは、Windows PowerShell の Get-PSSession コマンドレットが REST API 接続の情報を返さないためです。

  次の表では、 Get-ConnectionInformation を使用できるシナリオについて説明します。

  シナリオ	予想される出力
  Connect-ExchangeOnline または Connect-IPPSSession コマンドの後に実行します。	1 つの接続情報オブジェクトを返します。
  複数の Connect-ExchangeOnline または Connect-IPPSSession コマンドの後に実行します。	接続情報オブジェクトのコレクションを返します。

• Connect-ExchangeOnline コマンドレットの SkipLoadingFormatData スイッチを使用して、書式設定データの読み込みを回避し、Connect-ExchangeOnline コマンドをより速く実行します。

• REST API によってサポートされるコマンドレットには 15 分のタイムアウトがあり、一括操作に影響を与える可能性があります。 たとえば、配布グループの 10,000 人のメンバーを更新するための次の Update-DistributionGroupMember コマンドは、タイムアウトする可能性があります。

  $Members = @("member1","member2",...,"member10000")
  
  Update-DistributionGroupMember -Identity DG01 -Members $Members
  

  代わりに、 Update-DistributionGroupMember コマンドを使用して更新するメンバーを減らしてから、 Add-DistributionGroupMember コマンドを使用して残りのメンバーを個別に追加します。 例:

  Update-DistributionGroupMember -Identity DG01 -Members $Members[0..4999]
  
  $Remaining = $Members[-5000..-1]
  
  foreach ($Member in $Remaining)
  
  {
     Add-DistributionGroupMember -Identity DG01 -Member $Member
  }
  

EXO V3 モジュールの新機能の詳細については、この記事で後述する リリース ノート のセクションを参照してください。

Exchange Online PowerShell モジュールのプレビュー版のバグと問題を報告する

モジュールのプレビュー バージョンの場合のみ、exocmdletpreview[at]service[dot]microsoft[dot]com を使用して、発生する可能性のある問題を報告します。 必ずメール メッセージにログ ファイルを含めます。 ログ ファイルを生成するには、 <Path> を出力フォルダーに置き換え、次のコマンドを実行します。

Connect-ExchangeOnline -EnableErrorReporting -LogDirectoryPath <Path> -LogLevel All

Exchange Online PowerShell モジュールのコマンドレット

EXO モジュールには、Exchange Online PowerShell での一括データ取得シナリオ (何千ものオブジェクト) の速度に最適化された 9 つの専用 Get-EXO* コマンドレットが含まれています。 モジュール内の改善されたコマンドレットを次の表に示します。

モジュール内の接続関連のコマンドレットを次の表に示します。

モジュールに含まれているその他の Exchange Online 機能コマンドレットを次の表に示します。

Exchange Online PowerShell モジュールでサポートされているオペレーティング システム

このモジュールは、Windows、Linux、および Apple macOS の PowerShell 7 で正式にサポートされています。

• モジュール バージョン 3.10.0 (2026 年 6 月) 以降では、.NET 10.0 アセンブリの依存関係により、PowerShell 7.6.0 (2026 年 3 月) 以降が必要です。
• モジュール バージョン 3.5.0 (2024 年 5 月) から 3.9.2 (2026 年 1 月) では、.NET 8.0 アセンブリの依存関係により、PowerShell 7.4.0 (2023 年 11 月) 以降が必要です。 以前のバージョンの PowerShell 7 では互換性の問題が発生する可能性があります (モジュールとの互換性は PowerShell 7.3.7 よりも PowerShell 7.3.6 の方が優れています)。
• モジュール バージョン 3.0.0 (2022 年 9 月) から 3.4.0 (2023 年 10 月) では、REST API コマンドレットと接続での .NET 6.0 アセンブリの依存関係により、PowerShell 7.2.0 (2021 年 11 月) 以降が必要です。
• PowerShell 7 でのモジュールのサポートは、PowerShell 7.0.3 (2020 年 7 月) のバージョン 2.0.4 (2021 年 2 月) から開始されました。

PowerShell 7 の詳細については、「 PowerShell とは」を参照してください。

モジュールの macOS サポート

macOS に PowerShell 7 をインストールする手順については、「macOS への PowerShell のインストール」を参照してください。 PowerShell 7 をインストールした後、通常の PowerShell の前提条件を実行し、Exchange Online PowerShell モジュールをインストールして更新できます。

このモジュールは、次のバージョンの macOS でサポートされています。

macOS 14 Sonoma 以降

7.4.0 (.NET 8.0) は、macOS 14 Sonoma 以降でサポートされている PowerShell 7 の最も古いバージョンです。

macOS 13 Ventura

サポートされている PowerShell 7 の最新バージョンは 7.5.x (.NET 9.0) であるため、モジュールの最新のサポートされているバージョンは 3.9.2 です。

macOS 12 Monterey および macOS 11 Big Sur

サポートされている最新バージョンの PowerShell 7 は 7.4.x (.NET 8.0) であるため、モジュールの最新バージョンは 3.9.2 です。

モジュール バージョン 3.0.0 から 3.9.2 は、すべてのプロセッサでサポートされています。

モジュール バージョン 2.0.4 および 2.0.5 は、Intel プロセッサでネイティブに実行されます。 Apple M1 または Apple M2 プロセッサには Apple Rosetta 2 が必要です。

macOS 10.15 Catalina

PowerShell 7 のサポートされる最新バージョンが 7.2.22 (.NET 6.0) であるため、モジュールの最新バージョンは 3.4.0 です。

macOS 10.14 Mojave

サポートされている PowerShell 7 の最新バージョンが 7.1.5 (.NET 5.0) であるため、モジュールの最新バージョンは 2.0.5 です。

モジュールの Linux サポート

Linux に PowerShell 7 をインストールする手順については、「Linux への PowerShell のインストール」を参照してください。 PowerShell 7 をインストールした後、通常の PowerShell の前提条件を実行し、Exchange Online PowerShell モジュールをインストールして更新できます。

このモジュールは、以下の Linux ディストリビューションで正式にサポートされています。

Ubuntu 24.04 LTS

7.2.0 (.NET 6.0) は、Ubuntu 24.04 LTS でサポートされている PowerShell 7 の最も古いバージョンです。

Ubuntu 22.04 LTS

7.2.0 (.NET 6.0) は、Ubuntu 22.04 LTS でサポートされている PowerShell 7 の最も古いバージョンです。

Ubuntu 20.04 LTS

サポートされている最新バージョンの PowerShell 7 は 7.4.x (.NET 8.0) であるため、モジュールの最新バージョンは 3.9.2 です。

モジュール バージョン 3.7.0 から 3.9.2 は、SSL プロトコル エラーで失敗する可能性があります。

Ubuntu 18.04 LTS

サポートされている最新バージョンの PowerShell 7 は 7.4.x (.NET 8.0) であるため、モジュールの最新バージョンは 3.9.2 です。

モジュール バージョン 3.7.0 から 3.9.2 では、Ubuntu 18.04 LTS で信頼性の問題が発生する可能性があります。

モジュールの Windows サポート

Windows での特定のモジュール バージョンのサポートは、次のサブセクションで説明するように、Windows PowerShell のサポートと .NET Framework および/または .NET のサポートによって異なります。

Windows 11

Windows PowerShell 5.1 では、モジュールには .NET Framework 4.7.2 が必要です (4.8.x は Windows 11 に含まれているため、.NET Framework をインストールする必要はありません)。

7.2.0 (.NET 6.0) は、Windows 11 でサポートされている PowerShell 7 の最も古いバージョンです。

Windows Server 2022 および Windows Server 2025

Windows PowerShell 5.1 では、モジュールには .NET Framework 4.7.2 が必要です (4.8.x が含まれているため、.NET Framework をインストールする必要はありません)。

7.2.0 (.NET 6.0) は、Windows Server 2022 および Windows Server 2025 でサポートされている PowerShell 7 の最も古いバージョンです。

Windows 10

Windows PowerShell 5.1 では、モジュールには .NET Framework 4.7.2 が必要です。 Windows 10 April 2018 Update (バージョン 1803) 以降には .NET Framework 4.7.2 が含まれているため、ダウンロードする必要はありません。

Windows 10 では、.NET 8.0 と .NET 10.0 (したがって PowerShell 7.4 以降とモジュール バージョン 3.5.0 以降) は、現在サポートされている Enterprise および IoT LTSC エディション (バージョン 1607、1809、および 21H2) でのみサポートされます。

Windows 10 のコンシューマー エディションは 2025 年 10 月にサポートが終了し、.NET 8.0 または .NET 10.0 をサポートしていません。

Windows Server 2016 および Windows Server 2019

Windows PowerShell 5.1 では、モジュールを使用するには .NET Framework 4.7.2 (Windows Server 2019 に含まれます) が必要です。

Windows 8.1、Windows Server 2012、および Windows Server 2012 R2

Windows PowerShell 5.1 では、モジュールには .NET Framework 4.7.2 が必要です。

7.2.22 (.NET 6.0) は、Windows 8.1、Windows Server 2012、および Windows Server 2012 R2 でサポートされている PowerShell 7 の最新バージョンです。

Windows 7.1 SP1 および Windows Server 2008 R2 SP1

Windows PowerShell 5.1 では、モジュールには .NET Framework 4.7.1 が必要です。

Exchange Online PowerShell モジュールの前提条件

PowerShell 実行ポリシーを RemoteSigned に設定する

PowerShell を、スクリプトを実行するように構成する必要があります。既定では、スクリプトを実行するように構成されていません。 接続しようとすると、次のエラーが表示されます。

このシステムでスクリプトの実行が無効になっているため、ファイルを読み込めません。 ファイルの署名に使用する有効な証明書を指定します。

インターネットからダウンロードしたすべての PowerShell スクリプトに信頼された発行元の署名を要求するには、管理者特権の PowerShell セッション ([ 管理者として実行] を選択して開く PowerShell ウィンドウ) で次のコマンドを実行します。

Set-ExecutionPolicy RemoteSigned

実行ポリシーの詳細については、「実行ポリシーについて」を参照してください。

WinRM での基本認証

2023 年 10 月の時点で、REST API 接続は、Exchange Online PowerShell およびセキュリティ & コンプライアンス PowerShell の基本認証 (リモート PowerShell) 接続に置き換わりました。 REST API 接続では、WinRM の基本認証は必要ありません。

バージョン 3.2.0 (2023 年 6 月) 以降のバージョンのモジュールでは、Exchange Online PowerShell とセキュリティ & コンプライアンス PowerShell の REST API コマンドレットが完全にサポートされています。

Windows での PowerShellGet が必要

Windows での REST API 接続には、PowerShellGet モジュールが必要です。 依存関係によって、PowerShellGet モジュールには PackageManagement モジュールが必要です。 これらのモジュールについては、PowerShell 7 よりも PowerShell 5.1 の方が考慮されていますが、PowerShell のすべてのバージョンで最新バージョンのモジュールをインストールするとメリットがあります。 インストールと更新の手順については、「 Windows への PowerShellGet のインストール」を参照してください。

接続しようとしたときに PowerShellGet がインストールされていない場合、次のエラーが表示されます。

コマンドレット Update-Manifest が見つからない

Exchange Online PowerShell モジュールをインストールして更新する

このモジュールは、https://www.powershellgallery.com/packages/ExchangeOnlineManagement/ のPowerShell ギャラリーで入手できます。

Install-Module コマンドレットを使用してモジュールを初めてインストールし、Update-Module コマンドレットを使用して PowerShell ギャラリーから既存のインストールを更新します。 どちらのコマンドレットも同じパラメーターを使用するので、インストールする場合も更新する場合も、同じ構文が適用されます。

モジュールが既にインストールされているかどうか、およびそのインストール方法を確認するには、次の Get-InstalledModule ExchangeOnlineManagement | Format-List Name,Version,InstalledLocationを実行します。

• モジュールが %ProgramFiles%\WindowsPowerShell\Modules\ にインストールされている場合は、すべてのユーザー向けにインストールされます。
• モジュールが [ドキュメント] フォルダーにインストールされている場合は、現在のユーザー アカウントに対してのみインストールされます。

初めてモジュールをインストールする前に、「 PowerShellGet のインストール」の説明に従って PowerShellGet モジュールをインストールまたは更新し、PowerShell ウィンドウを閉じてもう一度開きます。

モジュールをインストールまたは更新するには、次の構文を使用します:

<Install-Module | Update-Module> -Name ExchangeOnlineManagement [-Scope CurrentUser] [-RequiredVersion <Version>] [-AllowPrerelease]

• 通常は、最新のパブリック バージョンのモジュールが必要ですが、プレビュー バージョンをインストールしたり、更新したりすることもできます。

• モジュールをインストールまたは更新する PowerShell セッションの要件:

  • すべてのユーザーの場合: 管理者特権の PowerShell セッションでコマンドを実行します。
  • 現在のユーザーの場合: 管理者特権の PowerShell セッションは必要ありません。

  モジュールを更新するときは、最初にインストールしたときと同じスコープを使用します。

• RequiredVersion パラメーターでは、インストールまたは更新するモジュールのバージョンを指定します。 このパラメーターは、 AllowPrerelease スイッチの有無にかかわらず使用できます。

• AllowPrerelease スイッチは、モジュールのインストールまたはプレビュー バージョンへの更新を行います。 プレビュー バージョンを指定するには、 RequiredVersion パラメーターも使用します。

  プレビュー バージョンを含む、モジュールのすべての利用可能なバージョンを表示するには、 Find-Module ExchangeOnlineManagement -AllVersions -AllowPrerelease を実行します。 パブリック バージョンのみを表示するには、 AllowPrerelease スイッチを省略します。

この例では、すべてのユーザーに対してモジュールの最新のパブリック バージョンをインストールします。

Install-Module -Name ExchangeOnlineManagement

この例では、現在のユーザー アカウントの最新のパブリック バージョンにモジュールを更新します。

Update-Module -Name ExchangeOnlineManagement -Scope CurrentUser

この例では、すべてのユーザー向けにモジュールの利用可能な最新のプレビュー バージョンをインストールします。

Install-Module -Name ExchangeOnlineManagement -AllowPrerelease

構文とパラメーターの詳細については、次の記事を参照してください。

• find-module
• install-module
• update-module
• Get-InstalledModule

Exchange Online PowerShell モジュールをアンインストールする

モジュールをアンインストールするには、次のコマンドを実行します。 最初にすべてのユーザー用にモジュールをインストールした場合は、管理者特権の PowerShell セッションでコマンドを実行します。

Uninstall-Module -Name ExchangeOnlineManagement

モジュールがどのようにインストールされたか (すべてのユーザーと現在のユーザー アカウント) を確認するには、「Exchange Online PowerShell モジュールのインストールと更新」セクションの冒頭にある Get-InstalledModule コマンドを使用します。

詳細な構文とパラメータ情報については、「Uninstall-Module」を参照してください。

Exchange Online PowerShell モジュールをインストールする場合のトラブルシューティング

このセクションでは、モジュールのインストール中に発生する可能性があるエラーと、それらを解決する方法について説明します。

• 次のいずれかのエラーが表示されます。

  PowerShellGetFormatVersion '<version>' を持つ指定されたモジュール 'ExchangeOnlineManagement' は、現在のバージョンの PowerShellGet ではサポートされていません。 このモジュール ' ExchangeOnlineManagement ' をインストールするには、PowerShellGet モジュールの最新バージョンを取得してください。

  警告: URI 'https://go.microsoft.com/fwlink/?LinkID=627338& からダウンロードすることができません。clcid=0x409' から ''。

  警告: 使用可能なプロバイダーの一覧をダウンロードできません。 インターネット接続をご確認ください。

  「PowerShellGet をインストールする」の説明に従って、PowerShellGet モジュールのインストールを最新バージョンに更新します。 ExchangeOnlineManagement モジュールを再度更新する前に、必ず PowerShell ウィンドウを閉じて再度開いてください。

• 次のエラーが表示されます。

  指定された検索条件とモジュール名 'ExchangeOnlineManagement' に一致するものが見つかりませんでした。 使用可能なすべての登録済みモジュール リポジトリを確認するには、 Get-PSRepository を実行してみてください。

  PowerShell モジュールの既定のリポジトリが PSGallery に設定されていません。 このエラーを解決するには、次のコマンドを実行します。

  Register-PSRepository -Default
  

• Windows PowerShell 5.1 では、モジュールをインストールしようとするとエラーが発生します。これは、PowerShell ギャラリーに TLS 1.2 以降の接続が必要であるためです (PowerShell 7 は既に TLS 1.2 以降を使用しています)。 この問題は通常、.NET Framework が既定で TLS 1.2 を使用しない古いバージョンの Windows にのみ影響します。 詳細とこれを解決する手順については、「 PowerShell ギャラリーの TLS サポート」を参照してください。

Exchange Online PowerShell モジュールのプロパティとプロパティ セット

従来の Exchange Online コマンドレットは、多くの空白のプロパティや興味のないプロパティを含め、使用可能なすべてのオブジェクト プロパティを返します。 この動作により、パフォーマンスが低下します （サーバーの計算量が増え、ネットワーク負荷が増加します）。 コマンドレットの出力では、プロパティの完全な補完が必要になることはほとんどありません。

モジュール内の Get-EXO* コマンドレットには、分類された出力プロパティが含まれています。 すべてのプロパティに等しい重要度を与えてすべてのシナリオで返すのではなく、関連する特定のプロパティを プロパティ セットに分類しました。 これらのプロパティ セットは、コマンドレット上の 2 つ以上の関連するプロパティのバケットです。

最大で最もよく使用される Get-EXO* コマンドレットは、プロパティ セットを使用します。

• Get-EXOCasMailbox
• Get-EXOMailbox
• Get-EXOMailboxStatistics
• Get-EXORecipient

これらのコマンドレットでは、次のパラメーターによってプロパティ セットが制御されます。

• PropertySets: このパラメーターは、コンマで区切られた 1 つ以上の使用可能なプロパティ セット名を受け取ります。 使用可能なプロパティ セットについては、「Exchange Online PowerShell モジュール コマンドレットのプロパティ セット」を参照してください。
• Properties: コンマで区切られた 1 つ以上のプロパティ名を受け取ります。

同じコマンドで、PropertySets パラメーターと Properties パラメーターを一緒に使うことができます。

また、コマンドレットの出力に必要なプロパティ (ID プロパティなど) の最小限のセットを含む最小プロパティ セットも含まれています。 最小プロパティ セットのプロパティについては、「Exchange Online PowerShell モジュール コマンドレットのプロパティ セット」でも説明します。

• PropertySetsまたはプロパティを 使用しない場合、プロパティは、自動的に最小プロパティセットに設定されます。
• PropertySets またはプロパティ パラメーターを使用する場合は、指定されたプロパティおよび最小プロパティセットのプロパティ を取得し ます。

どちらの方法でも、コマンドレットの出力に含まれるプロパティははるかに少なく、結果ははるかに短時間で返されます。

たとえば、Exchange Online PowerShell に接続した後、次の例では、最初の 10 個のメールボックスの Minimum プロパティ セットのプロパティのみが返されます。

Get-EXOMailbox -ResultSize 10

これに対し、同じ Get-Mailbox コマンドの出力は、最初の 10 個のメールボックスのそれぞれに対して少なくとも 230 個のプロパティを返します。

モジュール内のフィルター処理の詳細については、「Exchange Online PowerShell モジュールのフィルター」を参照してください。

リリース ノート

特に明記されていない限り、Exchange Online PowerShell モジュールの現在のリリースには、以前のリリースのすべての機能が含まれています。

現在のリリース

バージョン 3.10.1

• 証明書ベースの認証 (CBA) のバグとその他の軽微なパフォーマンスの問題を修正しました。

以前のリリース

バージョン 3.10.0

• このバージョンのモジュール以降、PowerShell 7 の最低限必要なバージョンは 7.6 です。 Windows PowerShell 5.1 は影響を受けません。
• EnableSearchOnlySession スイッチを使用したときに、Connect-IPPSSession で証明書ベースの認証 (CBA) が失敗する問題を修正しました。

バージョン 3.9.2

• Workforce Insights 委任用の新しい Add-WorkforceInsightsDelegationAccess、 Get-WorkforceInsightsDelegationAccess、 および Remove-WorkforceInsightsDelegationAccess コマンドレット。
• 一時 EXO モジュール ファイルをカスタム パスに格納するための Connect-ExchangeOnline および Connect-IPPSSession の新しい EXOModuleBasePath パラメーター。
• Connect-ExchangeOnline と Connect-IPPSSession の UseRpsSession パラメーターが非推奨になりました。

バージョン 3.9.0

• Connect-IPPSSession の新しい EnableSearchOnlySession スイッチ。これにより、他の Microsoft 365 サービスに接続する特定の電子情報開示コマンドレットおよび関連コマンドレットが有効になります。

バージョン 3.8.0

• Connect-IPPSSession の新しい AccessToken パラメーター。

• Get-VivaModuleFeature が ParentFeature、ChildFeature、PolicyModes に関する情報を返すようになりました。 これらの値は、Viva アプリ機能の親機能と子機能、および将来のポリシーで使用可能な有効化モードを表します。

• Add-VivaModuleFeaturePolicy コマンドレットと Update-VivaModuleFeaturePolicy コマンドレットの新しいパラメーター IsUserOptedInByDefault、およびすべての *-VivaModuleFeaturePolicy コマンドレットの対応するプロパティ値。 この値は、ユーザーが設定を設定しない限り、ユーザーがポリシーによってオプトインされているかオプトアウトされているかを示します。

  このパラメータを使用すると、影響を受けるユーザーをデフォルトでオプトアウトしながら、organization で機能を有効にしたままにし、それらのユーザーの機能を事実上ソフト無効にすることができます。

• Get-VivaFeatureCategory コマンドレット、すべてのカテゴリ関連のパラメーター、および戻り値 (CategoryId、IsCategoryEnabled) を非推奨にしました。

バージョン 3.7.2

• DisableWAM スイッチは、Connect-ExchangeOnline コマンドレットで、WAM 関連の接続エラーが発生した場合に Web アカウント マネージャー (WAM) を無効にするために使用できます。

バージョン 3.7.1

• Get-EXOMailbox の出力に、Get-Mailbox の出力の ExchangeSecurityDescriptor プロパティに似た ExoExchangeSecurityDescriptor という名前の新しいプロパティを追加しました。
• Viva Org Insights の委任機能をサポートするための新しいコマンドレットが追加されました。
  • Add-VivaOrgInsightsDelegatedRole
  • Get-VivaOrgInsightsDelegatedRole
  • Remove-VivaOrgInsightsDelegatedRole

バージョン 3.7.0

• セキュリティを強化するための認証フローに統合された Web アカウント マネージャー (WAM)。
• Exchange Online PowerShell コマンドレットのコマンド ライン ヘルプは、既定で読み込まれなくなりました。 Connect-ExchangeOnline コマンドの LoadCmdletHelp スイッチを使用すると、Exchange Online PowerShell コマンドレットのヘルプを Get-Help コマンドレットで利用できるようになります。
• セキュリティ & コンプライアンス PowerShell でのアプリのみの認証に関する接続の問題を修正しました。

バージョン 3.6.0

• Get-VivaModuleFeature は、機能がポリシーの作成をサポートする ID の種類 (ユーザー、グループ、organization全体など) に関する情報を返すようになりました。
• Viva 機能アクセス管理のコマンドレットが、継続的アクセス評価 (CAE) 要求の課題を処理するようになりました。
• Microsoft.Graph モジュールとの互換性の問題の修正を追加しました。

バージョン 3.5.1

• Get-EXOMailboxPermission と Get-EXOMailbox のバグ修正。
• モジュールは .NET 8 で実行されるようにアップグレードされ、.NET 6 に基づく以前のバージョンが置き換えられます。
• Add-VivaModuleFeaturePolicy の機能強化。

バージョン 3.5.0

• 新しい Get-VivaFeatureCategory コマンドレット。
• Viva 機能アクセス管理 (VFAM) のカテゴリ レベルでのポリシー操作のサポートが追加されました。
• Get-VivaModuleFeaturePolicy の出力にある新しい IsFeatureEnabledByDefault プロパティ。 このプロパティの値は、organization ポリシーまたはユーザー/グループ ポリシーが作成されていない場合のユーザーの既定の有効化状態を示します。

バージョン 3.4.0

• Connect-ExchangeOnline、Get-EXORecipientPermission、および Get-EXOMailboxFolderPermission のバグ修正。
• Connect-ExchangeOnline の SigningCertificate パラメーターで、制限付き言語モード (CLM) がサポートされるようになりました。

バージョン 3.3.0

• SkipLoadingCmdletHelp コマンドレット ヘルプ ファイルの読み込みのスキップをサポートするための Connect-ExchangeOnline のコマンドレット ヘルプ パラメーター。
• グローバル変数 EXO_LastExecutionStatus は、最後に実行されたコマンドレットの状態をチェックするために使用できます。
• Connect-ExchangeOnline と Connect-IPPSSession のバグ修正。
• Viva 機能アクセス管理にオンボードされている機能のポリシーによるユーザー制御の有効化をサポートするための、Add-VivaModuleFeaturePolicy と Update-VivaModuleFeaturePolicy の IsUserControlEnabled パラメーター。

バージョン 3.2.0

• 新しいコマンドレット:
  • Get-DefaultTenantBriefingConfig と Set-DefaultTenantBriefingConfig。
  • Get-DefaultTenantMyAnalyticsFeatureConfig と Set-DefaultTenantMyAnalyticsFeatureConfig。
  • Get-VivaModuleFeature、Get-VivaModuleFeatureEnablement、Add-VivaModuleFeaturePolicy、Get-VivaModuleFeaturePolicy、Remove-VivaModuleFeaturePolicy、および Update-VivaModuleFeaturePolicy。
• セキュリティ & コンプライアンス PowerShell の REST API 接続のサポート。
• Get-ConnectionInformation および Disconnect-ExchangeOnline の ConnectionId パラメーター:
  • 特定の REST API 接続の接続情報を取得します。
  • REST API 接続の選択的切断。
• Connect-ExchangeOnline の SigningCertificate パラメーターを使用すると、ファイル形式 (*.Connect-ExchangeOnline がクライアント証明書と共に作成して、すべての PowerShell 実行ポリシーで使用する一時モジュール内のスクリプト モジュール ファイル (.psm1) を Format.ps1xml) またはスクリプト モジュール ファイル (.psm1) に追加します。
• Connect-ExchangeOnline のバグ修正。

バージョン 3.1.0

• Connect-ExchangeOnline で使用できる AccessToken パラメーター。
• Connect-ExchangeOnline と Get-ConnectionInformation のバグ修正。
• CertificateThumbprint を使用してセキュリティ & コンプライアンス PowerShell に接続するための Connect-IPPSSession のバグ修正。

バージョン 3.0.0 (v2.0.6-PreviewX と呼ばれるプレビュー バージョン)

• EXO V3 モジュール セクションの REST API 接続で既に説明した機能:
  • セキュリティ & コンプライアンス PowerShell の証明書ベースの認証 (バージョン 2.0.6-Preview5 以降)。
  • REST ベースの接続用の Get-ConnectionInformation コマンドレット (バージョン 2.0.6-Preview7 以降)。
  • REST ベースの接続用の Connect-ExchangeOnline コマンドレットの SkipLoadingFormatData スイッチ (バージョン 2.0.6-Preview8 以降)。
• DelegatedOrganization パラメーターは、コマンドで AzureADAuthorizationEndpointUri パラメーターも使用している限り、Connect-IPPSSession コマンドレットで機能します。
• 特定のシナリオで確認を求めた特定のコマンドレットは、もはやそうしなくなりました。 既定では、コマンドレットは完了するまで実行されます。
• コマンドレットの実行が失敗した場合に返されるエラーの形式が若干変更されます。 例外に追加されたデータ (例外の種類など) が含まれるようになり、 FullyQualifiedErrorId に FailureCategoryは含まれなくなります。 エラーの形式はさらに変更される場合があります。

バージョン 2.0.5

• 所有者のいない Microsoft 365 グループを管理するための新しい Get-OwnerlessGroupPolicy コマンドレットと Set-OwnerlessGroupPolicy コマンドレット。

  注:

  cmdlets はモジュールで利用できますが、feature は Private Preview のメンバーのみ利用できます。

• Viva Insights の Headspace 機能へのユーザー アクセスを制御するための新しい Get-VivaInsightsSettings コマンドレットと Set-VivaInsightsSettings コマンドレット。

バージョン 2.0.4

• この記事の「Exchange Online PowerShell モジュールの前提条件」セクションで説明されているように、PowerShell 7 は Windows、Linux、および Apple macOS で正式にサポートされます。

• PowerShell 7 のモジュールは、ブラウザーベースのシングル サインオン (SSO) とその他のサインイン方法をサポートします。 詳細については、「 PowerShell 7 の排他接続方法」を参照してください。

• Get-UserAnalyticsConfig コマンドレットと Set-UserAnalyticsConfig コマンドレットは、Get-MyAnalyticsConfig コマンドレットと Set-MyAnalyticsConfig コマンドレットに置き換えられました。 機能レベルでアクセスを構成することもできます。 詳細については、「MyAnalytics を構成する」を参照してください。

• すべてのユーザーベースの認証におけるリアルタイム ポリシーとセキュリティ適用。 モジュールで継続的アクセス評価 (CAE) が有効になっています。 詳細については、「 リアルタイム ポリシーとセキュリティの適用に向けた移行」を参照してください。

• Get-EXOMailboxStatistics コマンドレットの出力で LastUserActionTime と LastInteractionTime プロパティを使用できるようになりました。

• 対話型のサインイン プロセスでは、安全な応答 URL を使用してアクセス トークンを取得できるより安全な方法を使用するようになりました。

バージョン 2.0.3

• 証明書ベースの認証 (CBA) が一般提供されました。これにより、無人スクリプトやバックグラウンド自動化のシナリオで最新の認証を使用できるようになります。 利用可能な証明書の保存場所は次のとおりです。
  • Azure Key 値 ( 証明書) パラメーターにあるリモート。 このオプションでは、実行時にのみ証明書を取得してセキュリティを強化します。
  • CurrentUser または LocalMachine 証明書ストアのローカル ( CertificateThumbprint パラメーター)。
  • エクスポートされた証明書ファイル (CertificateFilePath と CertificatePasswordパラメーター) にあるローカル。 詳細については、「Connect-ExchangeOnline」のパラメーターの説明および「Exchange Online PowerShell モジュールの無人スクリプトのアプリのみの認証」を参照してください。
• 1つの PowerShell ウィンドウで Exchange Online PowerShell とセキュリティ/コンプライアンス PowerShell に同時に接続します。
• 新しいCommandName パラメーターを使用すると、セッションにインポートされた Exchange Online PowerShell コマンドレットを指定して制限できます。 このオプションにより、使用率の高い PowerShell アプリケーションのメモリ占有領域が削減されます。
• Get-EXOMailboxFolderPermissionは、Identity パラメーターで ExternalDirectoryObjectID をサポートするようになりました。
• 最初の V2 コマンドレット呼び出しの最適化された待機時間。 ラボの結果によると、最初の通話の待機時間が 8 秒から約 1 秒に減少しました。 実際の結果は、コマンドレットの結果サイズと organization 環境によって異なります。

バージョン 1.0.1

• これは、EXO V2 モジュールの一般提供 (GA) バージョンです。 安定しており、運用環境ですぐに使用できます。
• Get-EXOMobileDeviceStatisticsコマンドレットが Identityパラメーターをサポートするようになりました。
• スクリプトが ~50 分間実行され、自動再接続ロジックのバグにより「コマンドレットが見つかりません」エラーをスローする特定のシナリオでのセッションの自動再接続の信頼性が向上しました。
• スクリプトを簡単に移行できるように、よく使用される2つの属性、 "User" と "MailboxFolderUser" について固定データタイプの問題を解決しました。
• フィルターのサポートが強化され、EndsWith、Contains、Not、NotLike の 4 つの演算子が追加されました。 フィルターでサポートされていない属性について、Exchange Online PowerShell モジュールのフィルターを確認します。

バージョン 0.4578.0

• ユーザーレベルでの組織のブリーフィングメールの構成に関するサポートが追加されました。Set-UserBriefingConfig と Get-UserBriefingConfig コマンドレットを使用します。
• Disconnect-ExchangeOnlineコマンドレットを使用したセッションのクリーンアップのサポート このコマンドレットは、Get-PSSession | Remove-PSSessionに相当する V2 です。 セッションオブジェクトやローカルファイルをクリーンアップするだけでなく、V2 コマンドレットに対して認証するために使用されるキャッシュからのアクセストークンを削除することもできます。
• EXOMailboxFolderPermissionのidentity パラメーターとして FolderId を使うことができるようになりました。 Get-MailboxFolderを使用して、FolderId 値を取得できます。 例: Get-MailboxFolderPermission -Identity <UPN>:<Folder-Path>Get-MailboxFolderPermission -Identity <UPN>:\<Folder-Id>
• エラーの原因となった特定の要求ルーティング エラーが解決されるので、 Get-EXOMailboxStatistics の信頼性が向上しました。
• セッションがインポートされるたびに新しいセッションを作成するのではなく、既存のモジュールを再利用して作成された新しいセッションのメモリ使用量を最適化しました。

バージョン 0.4368.1

• Connect-IPPSSession コマンドレットを使用してセキュリティ/コンプライアンス PowerShell コマンドレットのサポートが追加されました。
• ShowBanner スイッチを使用して、お知らせバナーを非表示にすることができます (-ShowBanner:$false)。
• クライアント例外でコマンドレットを終了する
• リモート PowerShell には、パフォーマンスを向上させるために EXO コマンドレットで意図的にサポートされなかったさまざまな複雑なデータ型が含まれていました。 リモート PowerShell コマンドレットと V2 コマンドレットの間の複雑でないデータ型の違いが解決され、管理スクリプトのシームレスな移行が可能になります。

バージョン 0.3582.0

• セッション作成中のプレフィックスのサポート:
  • プレフィックス付きのコマンドレットを含むセッションは、一度に 1 つだけ作成できます。
  • EXO V2 コマンドレットには、既にプレフィックス EXO があるためプレフィックスが付けられていないため、プレフィックスとして EXO を使用しないでください。
• クライアントコンピューターで WinRM 基本認証が無効になっていても、EXO V2 コマンドレットを使用します。 リモート PowerShell 接続には WinRM 基本認証が必要です。WinRM で基本認証が無効になっている場合は、リモート PowerShell コマンドレットを使用できません。
• V2 コマンドレットの ID パラメーターで、名前とエイリアスがサポートされるようになりました。 エイリアスまたは名前を使用すると、V2 コマンドレットのパフォーマンスが低下するため、使用はお勧めしません。
• V2 コマンドレットによって返される属性のデータ型がリモート PowerShell コマンドレットとは異なる問題が修正されました。 データ型が異なる属性はまだほとんどなく、今後数か月以内にそれらを処理する予定です。
• バグの修正: 資格情報または UserPrincipalName を使用して Connect-ExchangeOnline が呼び出されたときにセッションが頻繁に再接続される問題

バージョン 0.3555.1

• 認証の問題が原因で、パイプ処理されたコマンドレットが次のエラーで失敗したバグが修正されました。

  実行空間が Opened 状態でないため、パイプラインを呼び出せません。 実行空間の現在の状態は ' Closed ' です。

バージョン 0.3527.4

• 更新された Get-help コンテンツ。
• Online パラメーターがエラー コード 400 で存在しないページにリダイレクトされていた Get-Help の問題を修正しました。

バージョン 0.3527.3

• 委任フローを使用して別の organization の Exchange を管理するためのサポートが追加されました。
• 1 つの PowerShell ウィンドウ内で他の PowerShell モジュールと共に動作します。
• 位置パラメーターのサポートが追加されました。
• "日付/時刻フィールド" は、クライアントのロケールをサポートするようになりました。
• バグ修正: Connect-ExchangeOnlineの実行中に PSCredential が空になりました。
• バグ修正: フィルターに $null が含まれているときに、クライアントモジュールでエラーが発生しました。
• EXO V2 モジュール内に作成されたセッションに、名前を付けることができます (名前付けパターン: ExchangeOnlineInternalSession_% SomeNumber%)。
• バグ修正: トークンの有効期限とセッションがアイドル状態になる時間の差が原因で、リモート PowerShell コマンドレットが断続的に失敗する。
• 主要なセキュリティ更新
• バグの修正と強化された機能