Azure PowerShell を AzureRM から Az に移行する

AzureRM PowerShell モジュールを使用しているかどうかを確認する

次のコマンドを使用して、AzureRM PowerShell モジュールがインストールされているかどうかを確認します。

Get-Module -Name AzureRM -ListAvailable

また、パターン *-AzureRM* のスクリプトのフルテキスト検索を実行して、いずれかのスクリプトが AzureRM PowerShell モジュールを使用しているかどうかを判断することもできます。

Az PowerShell モジュールへのアップグレード

AzureRM コマンドレット用に記述されたスクリプトは、Az では自動的には機能しません。 移行を容易にするために、 AzureRM から Az への移行ツールキット が開発されました。 新しいコマンド セットへの移行は便利ではありませんが、この記事は Az PowerShell モジュールへの移行を開始するのに役立ちます。 Az PowerShell モジュールが作成された理由の詳細については、「 Az PowerShell モジュールの概要」を参照してください。

新しいコマンドレット名は、簡単に学習できるように設計されています。 コマンドレット名に AzureRm または Azure を使用する代わりに、 Azを使用します。 たとえば、古いコマンドレット New-AzureRMVm は New-AzVmになっています。 ただし、移行は新しいコマンドレット名に慣れ親しんでいます。 名前が変更されたモジュール、パラメーター、およびその他の重要な変更があります。

AzureRM と Az の間の重大な変更の完全な一覧については、 AzureRM から Az への完全な変更を参照してください。

既存のスクリプトが最新の AzureRM リリースで動作することを確認する

移行手順を実行する前に、システムにインストールされている AzureRM のバージョンを確認します。 これにより、最新リリースでスクリプトが既に実行されていることを確認し、アンインストールする必要がある AzureRM のバージョンを知らせることができます。

インストールした AzureRM のバージョンを確認するには、次の例を実行します。

Get-Module -Name AzureRM -ListAvailable -All

AzureRM の 最新 リリースは 6.13.2 です。 このバージョンをインストールしていない場合、既存のスクリプトでは、この記事と破壊的変更リストで説明されている範囲を超えて Az モジュールを操作するために、追加の 変更が必要になる場合があります。

スクリプトが AzureRM 6.13.2 で動作しない場合は、 AzureRM 5.x から 6.x への移行ガイドに従ってスクリプトを更新してください。 以前のバージョンの AzureRM モジュールを使用している場合は、メジャー バージョンごとに移行ガイドを使用できます。

オプション 1 (推奨): PowerShell スクリプトを自動的に移行する

この推奨オプションは、AzureRM スクリプトを Az に移行するために必要な作業を最小限に抑えます。

AzureRM から Az への移行ツールキットを使用すると、スクリプトに変更を加える前と Az PowerShell モジュールをインストールする前に、スクリプトに対して実行される変更を決定する計画を生成できます。

PowerShell スクリプトを AzureRM から Az PowerShell モジュールに自動的に移行するクイック スタートでは、PowerShell スクリプトを AzureRM から Az PowerShell モジュールに自動的に更新するプロセス全体について説明します。

オプション 2: Enable-AzureRmAlias で互換モードを使用する

Az モジュールには、新しい構文に更新するときに既存のスクリプトを使用するのに役立つ互換モードがあります。 Enable-AzureRmAlias コマンドレットは、エイリアスを使用して互換モードを有効にします。 このモードでは、Az への完全な移行に向けて作業しながら、最小限の変更で既存のスクリプトを使用できます。 既定では、 Enable-AzureRmAlias は現在の PowerShell セッションの互換性エイリアスのみを有効にします。 Scope パラメーターを使用して、PowerShell セッション間で互換性エイリアスを保持します。 詳細については、 Enable-AzureRmAlias リファレンス ドキュメントを参照してください。

azureRM PowerShell モジュールの廃止により、 Enable-AzureRmAlias のサポートは非推奨とされません。

次のステップ

• PowerShell スクリプトを自動的に移行する
• Az PowerShell モジュールの概要
• AzureRM と Az の間の変更
• Az PowerShell モジュールをインストールする
• AzureRM をアンインストールする