Az.Tools.Migration PowerShell モジュールの概要

Az.Tools.Migration PowerShell モジュールを使用すると、古い AzureRM モジュールから新しい Az モジュールへの移行が容易になります。これは、Azure 管理に推奨されます。

Microsoft は、お客様からのフィードバックに応じて Az.Tools.Migration を導入しました。特に、 最初に AzureRM 用に記述されたスクリプトを更新するために必要な作業について説明しました。 多くのお客様が Azure 環境用の複雑なスクリプトの作成に投資していることを認識し、 Az.Tools.Migration は移行プロセスを合理化および自動化するために作成されたため、手動ワークロードが削減され、スクリプトのアップグレード中にエラーが発生する可能性があります。

Az.Tools.Migration モジュールの使用方法

Az.Tools.Migration を使用するプロセスには、いくつかの手順が含まれます。

1. AzureRM バージョン 6.13.1 への更新:Az.Tools.Migration を使用する前に、ユーザーはスクリプトが、Az モジュールへの移行前の最後のバージョンである AzureRM バージョン 6.13.1 に更新されていることを確認する必要があります。

2. Az.Tools.Migration のインストール: モジュールは、 Install-Module -Name Az.Tools.Migration コマンドを使用して PowerShell ギャラリーからインストールできます。

3. アップグレード 計画の生成:New-AzUpgradeModulePlan コマンドレットは、アップグレード 計画を生成します。 既存のスクリプトは変更されませんが、更新が必要な特定のファイルとオフセット ポイントの詳細を示すプランを作成することで、アップグレード パスを提供します。 このコマンドレットは、特定のスクリプトまたはフォルダーを対象とする FilePath や DirectoryPath などのパラメーターを受け取ります。

4. アップグレード 計画の確認: アップグレードを実行する前に、スプラッティングを使用するコマンドなど、自動アップグレードを妨げる可能性がある潜在的な問題の計画を確認し、必要に応じて手動で修正することが重要です。

5. アップグレードの実行: 問題を確認して解決した後、実際のアップグレードは Invoke-AzUpgradeModulePlan コマンドレットを使用して実行されます。 このコマンドレットは、既存のファイルを変更するか、より安全に、名前に _az_upgraded を追加して新しいファイルに変更を保存して、元のスクリプトを保持することができます。

スムーズな移行を実現するには、 Invoke-AzUpgradeModulePlan コマンドレットを -FileEditMode SaveChangesToNewFiles オプションと共に使用しないと破壊的になる可能性があるため、アップグレードを実行する前にスクリプトをバックアップすることをお勧めします。

ユーザーは、 Azure-powershell-migration 用の GitHub リポジトリで移行プロセスに関するフィードバックを提供するか、問題を報告することをお勧めします。