次の方法で共有


Azure PowerShell のオフライン インストール

一部の環境では、インターネットまたは PowerShell ギャラリーに接続できません。 このような場合は、次のいずれかの方法を使用して、Az PowerShell モジュールをオフラインでインストールできます。

手記

この記事のオフライン インストールのオプションでは、Az PowerShell モジュールをダウンロードするには、インターネット にアクセスできる少なくとも 1 つのシステムが必要です。これは、モジュールをインストールする予定のシステムとは異なる場合があります。

前提 条件

  • サポートされているバージョンの PowerShell バージョン 7 以降の をインストールする
  • Windows オペレーティング システムを実行している場合は、Windows PowerShell 5.1 もサポートされます。

クロス プラットフォーム

Az PowerShell モジュールの次のインストール オプションは、Windows、Linux、macOS を含むすべてのプラットフォームでクロスプラットフォームで使用できます。

tar アーカイブからのインストール

ヒント

このインストール オプションを使用するには、tar コマンド ライン ユーティリティが必要です。 Windows 10 バージョン 1803 以降、ほとんどの Linux ディストリビューション、および macOS の現在のバージョンで既定で使用できます。

  1. インターネットにアクセスできるシステムで、tar アーカイブを保存する宛先パスを定義します。

    $downloadFolderPath = "$home/Downloads"
    
  2. ダウンロード フォルダーが存在するかどうかを確認します。 それ以外の場合は、フォルダーを作成します。

    if (-not (Test-Path -Path $downloadFolderPath -PathType Container)) {
        New-Item -Path $downloadFolderPath -ItemType Directory
    }
    
  3. GitHub の最新の Az PowerShell モジュール バージョンの tar アーカイブの URL を確認します。

    $tarSourceUrl = (
        Invoke-RestMethod -Uri https://api.github.com/repos/azure/azure-powershell/releases/latest |
        Select-Object -ExpandProperty assets | Where-Object content_type -eq 'application/x-gzip'
    ).browser_download_url
    
  4. tar ファイル名とコピー先ファイルパスを変数に格納します。

    $fileName = Split-Path -Path $tarSourceUrl -Leaf
    $downloadFilePath = Join-Path -Path $downloadFolderPath -ChildPath $fileName
    
  5. PowerShell を使用して GitHub から tar アーカイブをダウンロードします。

    Invoke-WebRequest -Uri $tarSourceUrl -OutFile $downloadFilePath
    
  6. Windows オペレーティング システムを実行している場合は、ダウンロードしたファイルのブロックを解除します。

    if ($PSVersionTable.PSVersion.Major -le 5 -or $IsWindows -eq $true) {
        Unblock-File -Path $downloadFilePath
    }
    

    手記

    tar アーカイブをオフライン システムにコピーします。 オフライン システムで次のコマンドで変数を使用する代わりに、$downloadFilePath 変数と $downloadFolderPath 変数を定義するか、実際の値を指定します。

  7. tar アーカイブの内容を抽出します。

    tar zxf $downloadFilePath -C $downloadFolderPath
    
  8. Az PowerShell モジュールをインストールするオフライン システムで、抽出されたファイルの 1 つである InstallModule.ps1 スクリプトを実行します。

    .$downloadFolderPath/InstallModule.ps1
    

インストールの保存とコピー

インターネットと PowerShell ギャラリーにアクセスできるシステムを使用して、Save-Module または Save-PSResource を含む Az PowerShell モジュールをネットワークの場所にダウンロードします。 これらのコマンドは、Az モジュールとその依存関係を指定した場所に保存します。 保存したモジュールをインストール ソースとして使用し、オフライン システムにコピーします。

プライベート リポジトリからインストールする

ローカル ネットワーク上にプライベート リポジトリを作成し、オフライン システムのインストール ソースとして使用します。 詳細については、「プライベート PowerShellGet リポジトリの使用」を参照してください。

この方法を使用すると、PowerShell モジュールを単一のサーバーまたはファイル共有にキャッシュし、PowerShellGet または Microsoft.PowerShell.PSResourceGet を利用して、任意の切断されたシステムにデプロイできます。

ウィンドウズ

Windows では、Windows PowerShell バージョン 5.1 を使用している場合は、MSI を使用して Az PowerShell モジュールをインストールすることもできます。

重要

MSI インストーラーは Windows PowerShell 5.1 でのみ機能することに注意してください。

トラブルシューティング

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

関連項目

次の手順

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