Az.Tools.Migration PowerShell モジュールの概要
Az.Tools.Migration PowerShell モジュールを使用すると、以前の AzureRM モジュールから、Azure の管理用として推奨される新しい Az モジュールへの移行が容易になります。
重要
AzureRM PowerShell モジュールは、2024 年 2 月 29 日に非推奨となります。
Microsoft では、お客様からのフィードバック (特に、当初 AzureRM 用に作成されたスクリプトを更新するために必要な作業に関するフィードバック) に応えて、Az.Tools.Migration を導入しました。 多くのお客様が Azure 環境用の複雑なスクリプトの作成に投資されていることを認識した上で、移行プロセスを合理化および自動化し、手動の作業負荷を軽減し、スクリプトのアップグレード中にエラーが発生する可能性を低減するために、Az.Tools.Migration が作成されました。
Az.Tools.Migration モジュールの使用方法
Az.Tools.Migration を使用するプロセスには、いくつかの手順が含まれます。
AzureRM バージョン 6.13.1 への更新: ユーザーは、Az.Tools.Migration を使用する前に、スクリプトが AzureRM バージョン 6.13.1 (Az モジュールに移行する前の最新バージョン) に更新されていることを確認する必要があります。
Az.Tools.Migration のインストール: このモジュールは、
Install-Module -Name Az.Tools.Migrationコマンドを使用して PowerShell ギャラリーからインストールできます。アップグレード プランの生成:
New-AzUpgradeModulePlanコマンドレットを使用してアップグレード プランを生成します。 これは、既存のスクリプトを変更するのではなく、更新に必要な特定のファイルとオフセット ポイントの詳細を示すプランを作成して、アップグレード パスを提供します。 このコマンドレットは、特定のスクリプトまたはフォルダーを対象とするために、FilePath や DirectoryPath などのパラメーターを受け取ります。アップグレード プランのレビュー: アップグレードを実行する前に、プランを見直して、スプラッティングを使用するコマンドなど、自動アップグレードを妨げる可能性のある潜在的な問題がないかどうかを確認し、必要に応じて手動で修正することが重要です。
アップグレードの実行: 問題を確認して解決したら、
Invoke-AzUpgradeModulePlanコマンドレットを使用して実際にアップグレードを実行します。 このコマンドレットで、既存のファイルを変更できますが、より安全な方法として、名前に_az_upgradedを追加した新しいファイルに変更を保存して、元のスクリプトを保持することもできます。
スムーズな移行を確実に行うには、アップグレードを実行する前にスクリプトをバックアップしておくことをお勧めします。Invoke-AzUpgradeModulePlan コマンドレットは、-FileEditMode SaveChangesToNewFiles オプションを使用しないと、破壊的変更を行う可能性があるためです。
ユーザーは、azure-powershell-migration の GitHub リポジトリで移行プロセスに関するフィードバックを提供するか、問題を報告することをお勧めします。