Merge pull request #892 from jpazureid/juntakata-batch-update

Update AAD MSOL PowerShell docs
jpazureid · Apr 7, 2024 · b591e6b · b591e6b
2 parents d036161 + 50050c9
commit b591e6b
Show file tree

Hide file tree

Showing 2 changed files with 85 additions and 31 deletions.
diff --git a/articles/azure-active-directory/azuread-module-retirement1.md b/articles/azure-active-directory/azuread-module-retirement1.md
@@ -8,22 +8,21 @@ tags:
 
 > [!NOTE]
 > 2022-10-03: 本記事の初版を投稿  
-> 2023-04-13: MSOL/AzureAD PowerShell の最新の廃止情報を反映  
-> 2023-06-19: 廃止日程の延期情報を反映
+> 2023-04-13: MSOL/AzureAD PowerShell の最新の非推奨情報を反映  
+> 2023-06-19: 非推奨の日程の延期情報を反映  
+> 2024-04-07: 非推奨のスケジュールのアップデートを反映 
 
 # MSOnline / AzureAD PowerShell から Graph PowerShell SDK への移行について 1_概要
 
 こんにちは、 Azure ID チームの小出です。
 
-今回は、MSOnline (以降 MSOL) および Azure AD PowerShell の廃止スケジュールについてご案内します。
+今回は、MSOnline (以降 MSOL) および Azure AD PowerShell の非推奨スケジュールについてご案内します。以前より、下記の弊社ブログにて、本内容については案内を行っていますが、情報のアップデートにより、複数の記事に分かれてしまうなどわかりにくくなっている状況でした。そこで今回は、現時点での最新情報と実施いただきたいこと、関連記事の URL などをまとめてご紹介します。
 
-以前より、下記の弊社ブログにて、本内容については案内を行っていますが、情報のアップデートにより、複数の記事に分かれてしまうなどわかりにくくなっている状況でした。そこで今回は、現時点での最新情報と実施いただきたいこと、関連記事の URL などをまとめてご紹介します。
+## 最新情報 (2024/4/7 最終更新) のまとめ
 
-## 最新情報 (2023/6/19 最終更新) のまとめ
+### MSOL / Azure AD PowerShell のライセンス割り当て関連のコマンド (2023/6/19 最終更新)
 
-### MSOL / Azure AD PowerShell のライセンス割り当て関連のコマンド
-
-ライセンス割り当てに関する MSOL / Azure AD PowerShell コマンド（Set-MsolUserLicense や Set-AzureADUserLicense など）は、2023/3/31 にすでに廃止されました。まだこのコマンドを利用しているお客様は、早急に新しいコマンドに移行ください。これらのコマンドは今後予告なく動作しなくなります。
+ライセンス割り当てに関する MSOL / Azure AD PowerShell コマンド (Set-MsolUserLicense や Set-AzureADUserLicense など) は、2023/3/31 にすでに廃止されました。まだこのコマンドを利用しているお客様は、早急に新しいコマンドに移行ください。これらのコマンドは今後予告なく動作しなくなります。
 
 新しいコマンドでのライセンス割り当て方法は、[本ブログ記事](https://jpazureid.github.io/blog/azure-active-directory/operating-license-with-microsoft-graph/) にてサンプルを用意しておりますので、併せてご確認ください。
 
@@ -64,56 +63,62 @@ tags:
   </tbody>
 </table>
 
-### MSOL / Azure AD PowerShell のライセンス割り当て関連「以外」のコマンドについて
+### MSOL / Azure AD PowerShell のライセンス割り当て関連「以外」のコマンドについて (2024/4/7 最終更新) 
+
+ライセンス割り当てに関するコマンド以外 (例: Connect-MsolService や Get-AzureADUser など) は、**2024 年 3 月 30 日 をもって非推奨となりました**。当初 2023 年 6 月 30 日 に非推奨となる予定でしたが、まだ Microsoft Graph API や新しい PowerShell モジュールで利用できないコマンドがあるために、対応も含め非推奨の日が 2024 年 3 月 30 日まで延期されていました。 
 
-ライセンス割り当てに関するコマンド以外（例: Connect-MsolService や Get-AzureADUser など）は、**2024 年 3 月 30 日** に廃止が延期されました。当初 2023 年 6 月 30 日 に廃止となる予定でしたが、まだ Microsoft Graph API や新しい PowerShell モジュールで利用できないコマンドがあります。引き続き以前のモジュールを利用しなければならないシナリオにおいて、コマンドの動作や今後の対応について多くお問い合わせをいただいておりましたので、対応も含め廃止日が延期されました。
-なお、日付のみアップデートがありましたが、対象範囲は特に変更ありません。MSOnline モジュール、AzureAD モジュールだけでなく、 AzureADPreview モジュールのコマンドも廃止されます。
+現在は MSOnline モジュール、AzureAD モジュールだけでなく、 AzureADPreview モジュールのコマンドも非推奨になりましたが、新しいコマンドの用意がなく引き続き以前のモジュールを利用しなければならないシナリオにおいて、コマンドの動作や今後の対応について多くお問い合わせをいただいております。今後は、MSOnline バージョン 1.1.166.0 (2017 年) 以降のみ、2025 年 3 月 30 日まで、重要なセキュリティ修正に対してのみサポートが提供されます。なお、1.1.166.0 より前のバージョンを使用すると、**2024 年 6 月 30 日以降にコマンドが動作しないなどの影響が発生する可能性がある** ためご注意ください。 
 
 対象となるコマンドは、Connect-MsolService や Get-AzureADUser コマンドだけでなく、 MSOL や AzureAD がつくコマンドすべてです。各モジュールのコマンド一覧は、下記公開情報にて紹介しています。
 
 [MSOnline モジュールのコマンド一覧](https://learn.microsoft.com/ja-jp/powershell/module/msonline/?view=azureadps-1.0#msonline)  
 [Azure AD モジュールのコマンド一覧（一般提供版）](https://learn.microsoft.com/en-us/powershell/module/azuread/?view=azureadps-2.0&preserve-view=true)  
 [Azure AD モジュールのコマンド一覧（プレビュー版）](https://learn.microsoft.com/en-us/powershell/module/azuread/?view=azureadps-2.0-preview&preserve-view=true)
 
-- 廃止予定日までは、これまでと同様にコマンドを利用可能です。
-- 廃止後は、動作の保証はされません。マイクロソフトは任意のタイミングで、MSOL / Azure AD (Preview) PowerShell の動作を停止する権利を有します。
+- MSOnline 1.1.166.0 以降のみ、今後も重要なセキュリティ修正に限定したサポートを提供しますが、それ以外はすべて 2024 年 3 月 30 日をもってすでに非推奨となります。以前のコマンドに関するご質問についてはお答えせず、新しいコマンドを利用するよう案内する場合がございます。 
+- 非推奨後は、動作の保証はされません。マイクロソフトは任意のタイミングで、MSOL / Azure AD (Preview) PowerShell の動作を停止する権利を有します。
 - ただし、マイクロソフトは使用状況を確認し、お客様が 3 つの PowerShell モジュールから移行するための猶予を提供した上で、これらモジュールの利用を停止させる予定です。
-- 従来の MSOL / AzureAD モジュールのコマンドでは実施できた操作が、Microsoft Graph API では実施できないものがあります。こうした操作を行う MSOL / Azure AD モジュールのコマンドも最終的には廃止されますが、Microsoft Graph でこれら API の代替の機能が提供されない限り、API およびコマンドレットを停止させることはありません。この対応に際し、廃止日が 2024 年 3 月 30 日に延期されました。
+- MSOnline 1.1.166.0 より前のバージョンは、 2024 年 6 月 30 日を目途に動作を停止する見込みです。1.1.166.0 より前のバージョンを使用すると、2024 年 6 月 30 日以降にコマンドが動作しないなど影響が生じる可能性があることをご理解ください。 
+- 従来の MSOL / AzureAD モジュールのコマンドでは実施できた操作が、Microsoft Graph API では実施できないものがあります。こうした操作を行う MSOL / Azure AD モジュールのコマンドも最終的には廃止されますが、Microsoft Graph でこれら API の代替の機能が提供されない限り、API およびコマンドレットを停止させることはありません。この対応に際し、非推奨の日付が 2024 年 3 月 30 日に延期されました。現時点でも代替コマンドがないものがあり、それについては引き続き提供されるまで以前のコマンドを利用できます。
 - 新しいモジュールのコマンドや代替 API があるものについては、2024/3/30 を過ぎるとすぐに利用できなくなる可能性があるため、引き続き早めに移行ください。
 - 2024/3/30 を過ぎても引き続き利用できるコマンド一覧の情報、実際に動作しなくなる具体的なコマンド一覧の情報などはありません。
 
-## いまできること・確認すること
+## いまできること & 確認すること
+
+今すぐ Microsoft Graph PowerShell に移行する準備をお進めください。具体的には下記内容を実施ください。 
 
-1. 現在利用しているコマンド・スクリプトなどを確認する。[こちらの記事](https://jpazureid.github.io/blog/azure-active-directory/how-to-determine-depreacated-azuread-msol/)をもとに、MSOL や Azure AD の PowerShell コマンドを利用していないか確認する
-2. MSOL や Azure AD の PowerShell コマンドを利用している場合、[こちらの公開情報](https://docs.microsoft.com/en-us/powershell/microsoftgraph/azuread-msoline-cmdlet-map?view=graph-powershell-1.0) にて対応するコマンドを探す
-3. 既存のスクリプトの書き換え、コマンドの置き換えを実施し、新しいモジュールで動作するよう修正する
-4. 利用中の MSOL や Azure AD コマンドの置き換えとなるものが見つからない、想定したように動作しない場合は、お問い合わせください
+1. 現在利用しているコマンドおよびスクリプトなどを確認する。[こちらの記事](https://jpazureid.github.io/blog/azure-active-directory/how-to-determine-depreacated-azuread-msol/) をもとに、MSOL や Azure AD の PowerShell コマンドを利用していないか確認する。
+2. MS Online モジュールのバージョンを調べるために、Get-InstalledModule MSOnline  の PowerShell コマンドを実行する。 
+3. 古いバージョンを利用している場合は、MSOnline PowerShell の最新バージョン（1.1.183.81）に更新する。これにより、2024 年 6 月 30 日以降の影響を回避できます。 
+4. MSOL や Azure AD の PowerShell コマンドを利用している場合、[こちらの公開情報](https://docs.microsoft.com/en-us/powershell/microsoftgraph/azuread-msoline-cmdlet-map?view=graph-powershell-1.0) にて対応するコマンドを探す。
+5. 2025 年 3 月 30 日までに、既存のスクリプトの書き換え、コマンドの置き換えを実施し、新しいモジュールで動作するよう修正する。
+6. 利用中の MSOL や Azure AD コマンドの置き換えとなるものが見つからない、想定したように動作しない場合はマイクロソフト サポートに問い合わせる。
 
 ##  本廃止に関する弊社ブログ記事リンク
 
 ### アップデート情報 (英語記事翻訳)
 
-[Azure AD Graph および MSOnline での従来のライセンスの割り当て方法が廃止され Microsoft Graph によるライセンス管理に変わります](https://jpazureid.github.io/blog/azure-active-directory/migrate-your-apps-to-access-the-license-managements/)
-[Azure AD の変更管理を簡素化します](https://jpazureid.github.io/blog/azure-active-directory/azure-ad-change-management-simplified/)  
-[Microsoft Entra の変更管理のアナウンス (2022 年 9 月の状況)](https://jpazureid.github.io/blog/azure-active-directory/Microsoft-Entra-change-announcements-September-2022-train/#Azure-AD%E3%80%81Azure-AD-Preview%E3%80%81MSOnline-PowerShell-%E3%81%AE%E5%BB%83%E6%AD%A2%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6)
-[Microsoft Entra の変更のアナウンス (2023 年 3 月の状況)](https://jpazureid.github.io/blog/azure-active-directory/microsoft-entra-change-announcements-march-2023-train/)  
-[重要 - Azure AD Graph の廃止と PowerShell モジュールの非推奨](https://jpazureid.github.io/blog/azure-active-directory/important-azure-ad-graph-retirement-and-powershell-module/)  
+- [Azure AD Graph および MSOnline での従来のライセンスの割り当て方法が廃止され Microsoft Graph によるライセンス管理に変わります](https://jpazureid.github.io/blog/azure-active-directory/migrate-your-apps-to-access-the-license-managements/)
+- [Azure AD の変更管理を簡素化します](https://jpazureid.github.io/blog/azure-active-directory/azure-ad-change-management-simplified/)  
+- [Microsoft Entra の変更管理のアナウンス (2022 年 9 月の状況)](https://jpazureid.github.io/blog/azure-active-directory/Microsoft-Entra-change-announcements-September-2022-train/#Azure-AD%E3%80%81Azure-AD-Preview%E3%80%81MSOnline-PowerShell-%E3%81%AE%E5%BB%83%E6%AD%A2%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6)
+- [Microsoft Entra の変更のアナウンス (2023 年 3 月の状況)](https://jpazureid.github.io/blog/azure-active-directory/microsoft-entra-change-announcements-march-2023-train/)  
+- [重要 - Azure AD Graph の廃止と PowerShell モジュールの非推奨](https://jpazureid.github.io/blog/azure-active-directory/important-azure-ad-graph-retirement-and-powershell-module/)  
 
 ### 既存モジュール使用状況について
 
-[Azure AD Graph / MSOnline PowerShell モジュール利用状況の調べ方](https://jpazureid.github.io/blog/azure-active-directory/how-to-determine-depreacated-azuread-msol/)
+- [Azure AD Graph / MSOnline PowerShell モジュール利用状況の調べ方](https://jpazureid.github.io/blog/azure-active-directory/how-to-determine-depreacated-azuread-msol/)
 
 ### 新しいモジュールへの移行導入
 
-[MSOnline / AzureAD PowerShell から Graph PowerShell SDK への移行について 2_移行導入編](https://jpazureid.github.io/blog/azure-active-directory/azuread-module-retirement2/)  
-[MSOnline / AzureAD PowerShell から Graph PowerShell SDK への移行について 3_インストール・接続編](https://jpazureid.github.io/blog/azure-active-directory/azuread-module-retirement3/)
+- [MSOnline / AzureAD PowerShell から Graph PowerShell SDK への移行について 2_移行導入編](https://jpazureid.github.io/blog/azure-active-directory/azuread-module-retirement2/)  
+- [MSOnline / AzureAD PowerShell から Graph PowerShell SDK への移行について 3_インストール・接続編](https://jpazureid.github.io/blog/azure-active-directory/azuread-module-retirement3/)
 
 ### 新しいモジュールの使用方法 (ライセンスに関する操作について)
 
-[Microsoft Graph PowerShell SDK を使用したライセンス管理操作の紹介](https://jpazureid.github.io/blog/azure-active-directory/operating-license-with-microsoft-graph/)
-[Microsoft Graph PowerShell SDK を使用したライセンス管理操作の紹介 (一括設定編)](https://jpazureid.github.io/blog/azure-active-directory/operating-license-with-microsoft-graph2/)
+- [Microsoft Graph PowerShell SDK を使用したライセンス管理操作の紹介](https://jpazureid.github.io/blog/azure-active-directory/operating-license-with-microsoft-graph/)
+- [Microsoft Graph PowerShell SDK を使用したライセンス管理操作の紹介 (一括設定編)](https://jpazureid.github.io/blog/azure-active-directory/operating-license-with-microsoft-graph2/)
 
 ### 新しいモジュールの使用方法 (ライセンス以外の操作について)
 
-[MSOnline / AzureAD PowerShell から Graph PowerShell SDK への移行について 4_ユーザー管理](https://jpazureid.github.io/blog/azure-active-directory/azuread-module-retirement4/)
-[MSOnline / AzureAD PowerShell から Graph PowerShell SDK への移行について 5_グループ管理](https://jpazureid.github.io/blog/azure-active-directory/azuread-module-retirement5/)
+- [MSOnline / AzureAD PowerShell から Graph PowerShell SDK への移行について 4_ユーザー管理](https://jpazureid.github.io/blog/azure-active-directory/azuread-module-retirement4/)
+- [MSOnline / AzureAD PowerShell から Graph PowerShell SDK への移行について 5_グループ管理](https://jpazureid.github.io/blog/azure-active-directory/azuread-module-retirement5/)