Windows に Azure PowerShell をインストールする

  • [アーティクル]

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

Az PowerShell モジュールの推奨されるインストール方法と PowerShell バージョンは以下のとおりです。

  • PowerShell ギャラリーからインストールする
  • PowerShell バージョン 7 以降を使用する

この記事では、PowerShell ギャラリーから Windows に Az PowerShell モジュールをインストールする方法について説明します。

前提条件

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

    $PSVersionTable.PSVersion

  • AzureRM PowerShell モジュールがインストールされているかどうかを確認します。

    Get-Module -Name AzureRM -ListAvailable

    重要

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

  • PowerShell スクリプトの実行をリモート署名済みまたは制限が緩い状態に設定します。

    • PowerShell 実行ポリシーを確認します。

      Get-ExecutionPolicy -List

    • PowerShell 実行ポリシーをリモート署名済みに設定します。

      Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

    実行ポリシーの詳細については、「about_Execution_Policies」を参照してください。

インストール

Az PowerShell モジュールをインストールするには、Install-Module コマンドレットを使用します。

Install-Module -Name Az -Repository PSGallery -Force

Az PowerShell モジュールを更新する

Update-Module を使用して、Az PowerShell モジュールの最新バージョンに更新します。

Update-Module -Name Az -Force

Update-Module を使用して Az PowerShell モジュールを更新しても、以前のバージョンの Az PowerShell モジュールはシステムから削除されません。

アンインストール

Az PowerShell モジュールを削除するには、「Azure PowerShell モジュールのアンインストール」を参照してください。

この記事では、MSI インストーラを使って Windows に Az PowerShell モジュールをインストールする方法について説明します。 MSI インストーラーは、PowerShell ギャラリーがファイアウォールによってブロックされる可能性がある環境や、オフライン インストーラーが必要な環境向けに用意されています。

重要

MSI インストール オプションは、Windows PowerShell 5.1 で使用するために Az PowerShell モジュールをインストールする場合にのみ使用できます。

前提条件

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

    $PSVersionTable.PSVersion

  • AzureRM PowerShell モジュールがインストールされているかどうかを確認する

    Get-Module -Name AzureRM -ListAvailable

    重要

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

  • Windows PowerShell 5.1 に更新する

  • .NET Framework 4.7.2 以降をインストールする

  • PowerShell スクリプトの実行をリモート署名済みまたは制限が緩い状態に設定する

    • PowerShell 実行ポリシーを確認します。

      Get-ExecutionPolicy -List

    • PowerShell 実行ポリシーをリモート署名済みに設定します。

      Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

    実行ポリシーの詳細については、「about_Execution_Policies」を参照してください。

インストールと更新

Azure PowerShell 用の MSI パッケージは GitHub から入手できます。

  1. github.com/Azure/azure-powershell/releases にアクセスする
  2. 最新の Az PowerShell モジュールを見つけます。 これらは、名前のない状態で時系列順に一覧表示されます。 たとえば、9.5.0 のように指定します。
  3. パッチのメモの一番下までスクロールし、[資産] の横にある矢印をクリックして MSI オプションを表示します。
  4. 任意の Az-Cmdlets MSI をクリックして、ダウンロードを開始する

インストーラによって、MSI を使用してインストールされた Az PowerShell モジュールの古いバージョンが自動的に削除されます。 MSI パッケージでは、"${env:ProgramFiles}\WindowsPowerShell\Modules" にモジュールがインストールされます。

サインイン

Az PowerShell モジュールを使用して Azure リソースの管理を開始するには、PowerShell セッションを起動し、Connect-AzAccount を実行して Azure にサインインします。

Connect-AzAccount

Azure アカウントのログイン資格情報を使用して、開いたブラウザー ウィンドウにログインします。

新しい PowerShell セッションを開始するたびに、この手順を繰り返す必要があります。 Azure サインインを PowerShell セッション間で維持する方法については、Azure PowerShell コンテキスト オブジェクトに関する記事を参照してください。

トラブルシューティング

Az PowerShell モジュールの一般的なインストールに関する問題の解決策については、Az PowerShell モジュールのインストールに関する問題のトラブルシューティングに関するページを参照してください。

フィードバックを提供する

Az PowerShell モジュールに関する問題を報告するには、「GitHub で問題を報告する」を参照してください。

PowerShell セッション内からフィードバックを提供するには、Send-Feedback コマンドレットを使用します。

次の手順

Az PowerShell モジュールを使用した Azure リソースの管理について詳しくは、「Azure PowerShellの概要」を参照してください。