Azure Az PowerShell モジュールをインストールする

  • [アーティクル]

この記事では、PowerShell ギャラリーから Azure Az PowerShell モジュールをインストールする方法について説明します。 これらの手順は、Windows、Linux、macOS プラットフォーム上で使用できます。

Azure Az PowerShell モジュールは、Azure Cloud Shell と Docker イメージにプレインストールされています。

Azure Az PowerShell モジュールはロールアップ モジュールです。 これをインストールすると、一般公開されている Az PowerShell モジュールがダウンロードされ、そのコマンドレットを使用できるようになります。

必要条件

Note

PowerShell 7.0.6 LTS、PowerShell 7.1.3 以降が、すべてのプラットフォームで Azure Az PowerShell モジュールに使用できる PowerShell の推奨バージョンです。

PowerShell 7.0.6 LTS および PowerShell 7.1.3 以降で実行する場合、Azure PowerShell にその他の要件はありません。

お使いの PowerShell のバージョンを確認するには、PowerShell セッション内から次のコマンドを実行します。

$PSVersionTable.PSVersion

PowerShell スクリプトの実行ポリシーは、リモート署名済みまたは制限を少なく設定する必要があります。 Get-ExecutionPolicy -List を使用して、現在の実行ポリシーを確認できます。 詳細については、「about_Execution_Policies」を参照してください。

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

インストール

Az PowerShell モジュールのインストール方法として推奨されるのは、Install-Module コマンドレットを使用することです。 Az モジュールは現在のユーザーのみを対象としてインストールします。 これが推奨されるインストール範囲です。 この方法は、Windows、Linux、macOS プラットフォーム上で同じように利用できます。 PowerShell セッションから次のコマンドを実行します。

Install-Module -Name Az -Scope CurrentUser -Repository PSGallery -Force

その他のインストール オプション

PowerShell 7.0.6 LTS、PowerShell 7.1.3 以降が PowerShell の推奨バージョンであり、Install-Module が推奨されるインストール オプションですが、必要に応じて他のインストール オプションがあります。

Windows PowerShell でのインストール

重要

AzureRM PowerShell モジュールがインストールされている場合は、次に進む前に、「Az と AzureRM の共存」を参照してください。

Azure Az PowerShell モジュールは、Windows 上の PowerShell 5.1 での使用もサポートされています。 Windows 上の PowerShell 5.1 で Azure Az PowerShell モジュールを使用するには、次の手順に従います。

  1. Windows PowerShell 5.1 に更新します。 Windows 10 バージョン 1607 以降の場合は、あらかじめ PowerShell 5.1 がインストールされています。
  2. .NET Framework 4.7.2 以降をインストールします。
  3. 最新バージョンの PowerShellGet がインストールされていることを確認します。 Install-Module -Name PowerShellGet -Force を実行します。

オフライン インストール

環境によっては、PowerShell ギャラリーに接続できない場合があります。 そのような場合でも、次のいずれかの方法を使用してオフラインで Az PowerShell モジュールをインストールできます。

  • Azure PowerShell MSI をダウンロードします。 MSI インストーラーは、Windows 上の PowerShell 5.1 でのみ動作することに注意してください。
  • モジュールをネットワーク内の別の場所にダウンロードし、それをインストール ソースとして使用します。 この方法により、1 台のサーバーまたはファイル共有に PowerShell モジュールをキャッシュして、任意の接続されていないシステムに PowerShellGet でデプロイすることができます。 ローカル リポジトリを設定して、切断されたシステムにインストールする方法については、「ローカルの PowerShellGet リポジトリの操作」で説明されています。
  • Save-Module を使用してモジュールをファイル共有に保存するか、別のソースに保存して他のコンピューターに手動でコピーします。

サインイン

Azure PowerShell を使用して作業を開始するには、Azure の資格情報を使用してサインインします。

Connect-AzAccount

このコマンドを実行すると、新しいブラウザー ウィンドウが表示され、Azure アカウントにログインできます。

Azure PowerShell モジュールの更新

PowerShell モジュールを更新するには、モジュールのインストールに使用したのと同じ方法を使用する必要があります。 たとえば、最初に Install-Module を使用した場合は、Update-Module を使用して最新バージョンを取得する必要があります。 最初に MSI パッケージを使用した場合は、新しい MSI をダウンロードしてインストールする必要があります。

PowerShellGet コマンドレットは、MSI パッケージからインストールされたモジュールを更新できません。 MSI パッケージは、PowerShellGet を使用してインストールされたモジュールを更新しません。 PowerShellGet を使用した更新で問題が発生した場合は、更新ではなく再インストールを行う必要があります。 再インストールは、インストールと同じ方法で行います。 再インストール時に、Install-Module で Force パラメーターを必ず使用します。

MSI ベースのインストールとは異なり、PowerShellGet を使用してインストールまたは更新を行っても、システム上に存在する古いバージョンは削除されません。

注意

複数のバージョンの Azure PowerShell モジュールがインストールされている場合、アンインストールが複雑になることがあります。 この複雑さのため、サポートされるのは、インストールされている Az PowerShell モジュールのすべてのバージョンのアンインストールのみです。

Az PowerShell のすべてのバージョンをシステムから削除するには、Azure PowerShell モジュールのアンインストールに関する記事を参照してください。 MSI ベースのインストールの詳細については、「MSI を使用して Azure PowerShell をインストールする」を参照してください。

トラブルシューティング

Azure Az PowerShell モジュールのインストールに関する問題のトラブルシューティング。

フィードバックの提供

Azure Az PowerShell モジュールにバグが見つかった場合は、GitHub でイシューを報告してください。 PowerShell セッション内からフィードバックを提供するには、Send-Feedback コマンドレットを使用します。

次の手順

Azure Az PowerShell モジュールとその機能の詳細については、「Azure PowerShell の概要」を参照してください。 Azure PowerShell に精通していて、AzureRM から移行する必要がある場合は、AzureRM から Az への移行に関するページを参照してください。