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

[アーティクル]
07/25/2022

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

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 のバージョンを確認するには、PowerShell セッション内から次のコマンドを実行します。

$PSVersionTable.PSVersion

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

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

インストール

Az PowerShell モジュールのインストール方法として推奨されるのは、Install-Module コマンドレットを使用することです。 Az モジュールは現在のユーザーのみを対象としてインストールします。これが推奨されるインストール範囲です。この方法は、Windows、macOS、Linux プラットフォーム上で同じように利用できます。 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 モジュールを使用するには、次の手順に従います。

Windows PowerShell 5.1 に更新します。 Windows 10 バージョン 1607 以降の場合は、あらかじめ PowerShell 5.1 がインストールされています。
.NET Framework 4.7.2 以降をインストールします。
最新バージョンの 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 モジュールのインストール時に発生する一般的な問題をいくつか取り上げます。ここに示されていない問題が発生した場合は、GitHub で問題を報告してください。

Az と AzureRM の共存

警告

Windows では PowerShell 5.1 に対して AzureRM と Az の両方のモジュールを同時にインストールすることはサポートされていません。

AzureRM と Az PowerShell モジュールの両方を同じシステムにインストールする場合は、AzureRM を Windows PowerShell のユーザースコープにのみインストールする必要があります。同じシステムに、PowerShell 7.0.6 LTS、PowerShell 7.1.3 以降用の Az PowerShell モジュールをインストールします。

重要

Az PowerShell モジュールで AzureRM PowerShell モジュールのすべての機能およびその他を利用できるようになったため、2024 年 2 月 29 日に AzureRM PowerShell モジュールは廃止になります。

サービスの中断を回避するために、2024 年 2 月 29 日までに、AzureRM PowerShell モジュールを使用するスクリプトを更新して、Az PowerShell モジュールを使用するようにしてください。スクリプトを自動的に更新するには、クイックスタートガイドに従ってください。

Visual Studio

以前のバージョンの Visual Studio では、Azure 開発ワークロードの一部として Azure PowerShell がインストールされる場合があり、これにより AzureRM モジュールがインストールされます。 Azure PowerShell を削除するには、Visual Studio インストーラーを使用するか、[アプリと機能] の [アンインストール] を使用します。 PowerShell 7.x を既にインストールしている場合は、Azure Az PowerShell モジュールを手動でインストールする必要がある場合があります。

プロキシによる接続のブロック

PowerShell ギャラリーにアクセスできないというエラーが Install-Module で発生した場合は、プロキシの内側にいる可能性があります。システム全体のプロキシを構成するための要件は、オペレーティングシステムとネットワーク環境によってさまざまに異なります。プロキシ設定と、ご使用の環境での構成方法については、システム管理者にお問い合わせください。

PowerShell 自体は、このプロキシを自動的に使用するように構成されていない場合があります。 PowerShell 5.1 以降では、次のコマンドを使用して、プロキシを使用するように PowerShell セッションを構成します。

$webClient = New-Object -TypeName System.Net.WebClient
$webClient.Proxy.Credentials = [System.Net.CredentialCache]::DefaultNetworkCredentials

オペレーティングシステムの資格情報が正しく構成されている場合は、この構成により PowerShell 要求がプロキシ経由でルーティングされます。この設定をセッション間で保持するには、このコマンドを PowerShell プロファイルに追加します。

パッケージをインストールするには、プロキシで www.powershellgallery.com への HTTPS 接続を許可する必要があります。

フィードバックの提供

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

次の手順

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