[What and why:]

As part of our ongoing Exchange Online management and directory modernization efforts, we’re simplifying legacy management scenarios and removing properties. We are deprecating selected properties returned or used with the following Exchange Online PowerShell scenarios:

• Get-Mailbox -Migration
• New-Mailbox -Migration

If your scripts, applications, or automation use these scenarios, review the affected properties and determine whether your workflows depend on them.

The change will be introduced in two phases:

• Beginning November 15, 2026: Selected properties will no longer be returned in applicable Get-Mailbox -Migration and New-Mailbox -Migration responses.
• Beginning December 15, 2026: The affected properties will be blocked from being configured through applicable New-Mailbox -Migration scenarios.

[Rollout schedule:]

We will begin rolling out mid-November 2026 and expect to complete by mid-November 2026.

[Impact on your organization:]

Your organization may be affected if you have scripts, applications, third-party solutions, or operational workflows that use the affected properties with -Migration scenarios.

For example, a script using: Get-Mailbox -Migration will no longer receive the affected properties in the returned object beginning November 10, 2026. This may affect automation that depends on those properties being present or expects a fixed set of properties in the response. If your workflows don’t use any of the affected properties, no action is required.

[Action required / Recommendations:]

Before November 15, 2026:

1. Review scripts, applications, and integrations that use Get-Mailbox -Migration, New-Mailbox -Migration, or Set-Mailbox -Migration.
2. Review the published list of affected properties.
3. Identify whether your workflows depend on any affected property.
4. Update and test affected workflows to remove the dependency.
5. For the complete list of affected properties and additional guidance, see: Changes to Get-Mailbox and New-Mailbox specifically with the Migration parameter | Microsoft Learn.

Required Actions

Review your -Migration workflows and make any required changes before November 15, 2026.

If an affected property is required for your scenario and you can’t remove the dependency, contact Microsoft Support and provide the property name, cmdlet, usage scenario, and expected impact.

[何を、なぜ:]

Exchange Onlineの管理およびディレクトリの近代化の一環として、レガシー管理シナリオを簡素化し、プロパティを削除しています。以下のExchange Online PowerShellシナリオで戻されたまたは使用された特定のプロパティは非推奨化します。

• Get-Mailbox -Migration
• New-Mailbox -Migration

スクリプト、アプリケーション、自動化がこれらのシナリオを使用している場合は、影響を受けるプロパティを確認し、ワークフローがそれに依存しているかどうかを判断してください。

この変更は2段階で導入されます。

• 2026年11月15日より:選ばれた物件は、該当する「Get-Mailbox -Migration」および「New-Mailbox -Migration」の回答で返却されなくなります。
• 2026年12月15日より:影響を受けたプロパティは、該当するNew-Mailbox -Migrationシナリオを通じて設定がブロックされます。

[展開スケジュール:]

2026年11月中旬から展開を開始し、11月中旬までに完了する予定です。

[組織への影響:]

影響を受けるプロパティを-Migrationシナリオで使用しているスクリプト、アプリケーション、サードパーティソリューション、運用ワークフローがいれば、組織が影響を受ける可能性があります。

例えば、 Get-Mailbox -Migration を使うスクリプトは、2026年11月10日以降、返還されたオブジェクト内の影響を受けたプロパティを受け取らなくなります。これにより、これらのプロパティが存在することに依存したり、レスポンスに固定されたプロパティセットを期待する自動化に影響が出る可能性があります。もしワークフローが影響を受けたプロパティを一切使わなければ、何のアクションも必要ありません。

[必要な行動/推奨事項:]

2026年11月15日以前:

1. Get-Mailbox -Migration、New-Mailbox -Migration、またはSet-Mailbox -Migrationを使用するスクリプト、アプリケーション、統合を見直してください。
2. 影響を受ける物件のリストを公開したリストを確認してください。
3. ワークフローが影響を受ける物件に依存しているかどうかを特定しましょう。
4. 影響を受けたワークフローを更新・テストして依存を除去してください。
5. 影響を受けるプロパティの完全なリストおよび追加のガイダンスについては、以下をご覧ください: Migrationパラメータに関するGet-MailboxおよびNew-Mailboxの変更 |Microsoft Learn。

必要な行動

-Migrationのワークフローを見直し、2026年11月15日までに必要な変更を行いましょう。

影響を受けるプロパティがシナリオで必要で、依存関係を解除できない場合は、Microsoft サポートに連絡し、プロパティ名、コマンドレット、使用状況、予想される影響を伝えてください。