この記事では、 PowerShellGet を使用して Azure PowerShell モジュールをインストールする方法について説明します。 これらの手順は、Windows、Linux、および macOS プラットフォームで動作します。
Azure PowerShell は、Azure Cloud Shell でも使用できます。
必要条件
Azure PowerShell は、Windows 上の PowerShell 5.1 以降、またはすべてのプラットフォームで PowerShell Core 6.x 以降で動作します。 オペレーティング システムで使用できる 最新バージョンの PowerShell をインストールする必要があります。 PowerShell 6.2.4 以降で実行する場合、Azure PowerShell には追加の要件はありません。
PowerShell のバージョンを確認するには、次のコマンドを実行します。
$PSVersionTable.PSVersion
Windows 上の PowerShell 5.1 で Azure PowerShell を使用するには:
- Windows PowerShell 5.1 に更新します。 バージョン 1607 以降Windows 10している場合は、既に PowerShell 5.1 がインストールされています。
- .NET Framework 4.7.2 以降をインストールします。
- 最新バージョンの PowerShellGet があることを確認します。
Install-Module -Name PowerShellGet -Forceを実行します。
Azure PowerShell モジュールをインストールする
警告
PowerShell 5.1 用の AzureRM モジュールと Az モジュールの両方を Windows に同時にインストールすることはサポートされていません。 システムで AzureRM を使用できるようにする必要がある場合は、PowerShell 6.2.4 以降用の Az モジュールをインストールします。
推奨されるインストール方法は、PowerShellGet コマンドレットを使用することです。 現在のユーザー専用の Az モジュールをインストールします。 これが推奨されるインストール範囲です。 この方法は、Windows、Linux、および macOS プラットフォームでも同じように動作します。 PowerShell セッションから次のコマンドを実行します。
if (Get-Module -Name AzureRM -ListAvailable) {
Write-Warning -Message ('Az module not installed. Having both the AzureRM and ' +
'Az modules installed at the same time is not supported.')
} else {
Install-Module -Name Az -AllowClobber -Scope CurrentUser
}
既定では、PowerShell ギャラリーは、PowerShellGet の信頼できるリポジトリとしては構成されません。 PSGallery を初めて使用すると、次のプロンプトが表示されます。
Untrusted repository
You are installing the modules from an untrusted repository. If you trust this repository, change
its InstallationPolicy value by running the `Set-PSRepository` cmdlet.
Are you sure you want to install the modules from 'PSGallery'?
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "N"):
YesまたはYes to Allに応答して、インストールを続行します。
システム上のすべてのユーザーにモジュールをインストールするには、昇格された特権が必要です。 Windows で 管理者として実行 を使用して PowerShell セッションを開始するか、macOS または Linux で sudo コマンドを使用します。
if (Get-Module -Name AzureRM -ListAvailable) {
Write-Warning -Message ('Az module not installed. Having both the AzureRM and ' +
'Az modules installed at the same time is not supported.')
} else {
Install-Module -Name Az -AllowClobber -Scope AllUsers
}
Az モジュールは、Azure PowerShell コマンドレットのロールアップ モジュールです。 インストールすると、一般公開されているすべての Az PowerShell モジュールがダウンロードされ、コマンドレットを使用できるようになります。
オフラインでインストールする
一部の環境では、PowerShell ギャラリーに接続できません。 このような場合でも、次のいずれかの方法を使用してオフラインでインストールできます。
モジュールをネットワーク内の別の場所にダウンロードし、インストール ソースとして使用します。 このメソッドを使用すると、PowerShell モジュールを 1 つのサーバーまたはファイル共有にキャッシュし、PowerShellGet を使用して切断されたシステムにデプロイできます。 ローカル PowerShellGet リポジトリを活用して、ローカルリポジトリを設定し、切断されたシステムにインストールする方法を学びます。
ネットワークに接続されているマシンに Azure PowerShell MSI をダウンロードし、PowerShell ギャラリーにアクセスせずにインストーラーをシステムにコピーします。 MSI インストーラーは、Windows 上の PowerShell 5.1 でのみ動作することに注意してください。
Save-Module を使用してモジュールをファイル共有に保存するか、別のソースに保存して他のマシンに手動でコピーします。
Save-Module -Name Az -Path '\\server\share\PowerShell\modules' -Force
トラブルシューティング
Azure PowerShell モジュールをインストールするときに発生する一般的な問題を次に示します。 ここに記載されていない問題が発生した場合は、 GitHub で問題を報告してください。
プロキシによる接続のブロック
PowerShell ギャラリーに到達できないことを示すエラーが Install-Module から発生した場合は、プロキシの背後にある可能性があります。 システム全体のプロキシを構成するための要件は、オペレーティング システムとネットワーク環境によってさまざまに異なります。 プロキシ設定と、ご使用の環境での構成方法については、システム管理者にお問い合わせください。
PowerShell 自体は、このプロキシを自動的に使用するように構成されていない場合があります。 PowerShell 5.1 以降では、次のコマンドを使用して、プロキシを使用するように PowerShell セッションを構成します。
$webClient = New-Object System.Net.WebClient
$webClient.Proxy.Credentials = [System.Net.CredentialCache]::DefaultNetworkCredentials
オペレーティング システムの資格情報が正しく構成されている場合、この構成ではプロキシ経由で PowerShell 要求がルーティングされます。 セッション間でこの設定を保持するには、 PowerShell プロファイルにコマンドを追加します。
パッケージをインストールするには、プロキシで次のアドレスへの HTTPS 接続を許可する必要があります。
https://www.powershellgallery.com
サインイン
Azure PowerShell の使用を開始するには、Azure 資格情報でサインインします。
# Connect to Azure with a browser sign in token
Connect-AzAccount
注
モジュールの自動読み込みを無効にした場合は、 Import-Module -Name Azを使用してモジュールを手動でインポートします。
モジュールの構造が原因で、これには数秒かかることがあります。
開始するすべての新しい PowerShell セッションに対して、これらの手順を繰り返す必要があります。 PowerShell セッション間で Azure サインインを保持する方法については、「PowerShell セッション 間でユーザー資格情報を保持する」を参照してください。
Azure PowerShell モジュールを更新する
PowerShell モジュールを更新するには、モジュールのインストールに使用するのと同じ方法を使用する必要があります。 たとえば、最初に Install-Module を使用していた場合は、 Update-Module を使用して最新バージョンを取得する必要があります。 MSI パッケージを最初に使用した場合は、新しい MSI パッケージをダウンロードしてインストールする必要があります。
PowerShellGet コマンドレットは、MSI パッケージからインストールされたモジュールを更新できません。 MSI パッケージでは、PowerShellGet を使用してインストールされたモジュールは更新されません。 PowershellGet を使用した更新で問題が発生した場合は、更新ではなく再インストールする必要があります。 再インストールはインストールと同じ方法で行われますが、 -Force パラメーターを追加する必要があります。
if (Get-Module -Name AzureRM -ListAvailable) {
Write-Warning -Message ('Az module not installed. Having both the AzureRM and ' +
'Az modules installed at the same time is not supported.')
} else {
Install-Module -Name Az -AllowClobber -Force
}
MSI ベースのインストールとは異なり、PowerShellGet を使用してインストールまたは更新しても、システムに存在する可能性のある古いバージョンは削除されません。 システムから古いバージョンの Azure PowerShell を削除するには、「 Azure PowerShell モジュールのアンインストール」を参照してください。 MSI ベースのインストールの詳細については、「MSI を使用した Azure PowerShell のインストール」を参照してください。
複数のバージョンの Azure PowerShell を使用する
複数のバージョンの Azure PowerShell をインストールできます。 複数のバージョンの Azure PowerShell がインストールされているかどうかを確認するには、次のコマンドを使用します。
Get-InstalledModule -Name Az -AllVersions | Select-Object -Property Name, Version
Azure PowerShell のバージョンを削除するには、「 Azure PowerShell モジュールのアンインストール」を参照してください。
複数のバージョンのモジュールがインストールされている場合は、既定でモジュールが自動読み込みされ、最新バージョン Import-Module 読み込まれます。
Az パラメーターを使用して、-RequiredVersion モジュールの特定のバージョンをインストールまたは読み込むことができます。
# Install Az version 3.6.1
Install-Module -Name Az -RequiredVersion 3.6.1
# Load Az version 3.6.1
Import-Module -Name Az -RequiredVersion 3.6.1
フィードバックを提供する
Azure PowerShell でバグが見つかる場合は、 GitHub で問題を報告してください。 コマンド ラインからフィードバックを提供するには、 Send-Feedback コマンドレットを使用します。
次のステップ
Azure PowerShell モジュールとその機能の詳細については、「Azure PowerShellの概要」を参照してください。 Azure PowerShell について理解していて、AzureRM から移行する必要がある場合は、「 AzureRM から Az への移行」を参照してください。