Azure PowerShell モジュールのインストールInstall the Azure PowerShell module

この記事では、PowerShellGet を使用して Azure PowerShell モジュールをインストールする方法を説明します。This article tells you how to install the Azure PowerShell modules using PowerShellGet. これらの手順は、Windows、macOS、および Linux プラットフォーム上で使用できます。These instructions work on Windows, macOS, and Linux platforms. Az モジュールについては、現在他のインストール方法はサポートされていません。For the Az module, currently no other installation methods are supported.

必要条件Requirements

Azure PowerShell は、Windows にインストールされている PowerShell 5.1 以降、または任意のプラットフォーム上の PowerShell 6 上で動作します。Azure PowerShell works with PowerShell 5.1 or higher on Windows, or PowerShell 6 on any platform. PowerShell のバージョンを確認するには、次のコマンドを実行します。To check your PowerShell version, run the command:

$PSVersionTable.PSVersion

期限切れのバージョンをお使いの場合や PowerShell をインストールする必要がある場合は、「PowerShell のさまざまなバージョンのインストール」を参照してください。If you have an outdated version or need to install PowerShell, see Installing various versions of PowerShell. お使いのプラットフォームでのインストール情報については、そのページにリンクがあります。Install information for your platform is linked from that page.

Windows で PowerShell 5 を使用している場合は、.NET Framework 4.7.2 もインストールする必要があります。If you are using PowerShell 5 on Windows, you also need .NET Framework 4.7.2 installed. 新しいバージョンの .NET Framework を更新またはインストールする手順については、.NET Framework のインストール ガイドを参照してください。For instructions on updating or installing a new version of .NET Framework, see the .NET Framework installation guide.

Azure PowerShell モジュールのインストールInstall the Azure PowerShell module

重要

AzureRM と Az の両方のモジュールを同時にインストールすることができます。You can have both the AzureRM and Az modules installed at the same time. 両方のモジュールをインストールした場合は、__別名を有効にしない__でください。If you have both modules installed, don't enable aliases. 別名を有効にすると、AzureRM コマンドレットと Az コマンドの別名との間に競合が発生して、予期しない動作が起こる可能性があります。Enabling aliases will cause conflicts between AzureRM cmdlets and Az command aliases, and could cause unexpected behavior. Az モジュールをインストールする前に、AzureRM をアンインストールすることをお勧めします。It's recommended that before installing the Az module, you uninstall AzureRM. AzureRM のアンインストールや別名の有効化はいつでもできます。You can always uninstall AzureRM or enable aliases at any time. AzureRM コマンドの別名の詳細については、AzureRM から Az への移行に関するページを参照してください。To learn about the AzureRM command aliases, see Migrate from AzureRM to Az. アンインストールの手順については、「AzureRM モジュールをアンインストールする」を参照してください。For uninstall instructions, see Uninstall the AzureRM module.

グローバル スコープでモジュールをインストールするには、PowerShell ギャラリーからモジュールをインストールするための、昇格された特権が必要です。To install modules at a global scope, you need elevated privileges to install modules from the PowerShell Gallery. Azure PowerShell をインストールするには、管理者特権セッション (Windows の場合は [管理者として実行]、macOS または Linux の場合はスーパーユーザー権限) で、次のコマンドを実行します。To install Azure PowerShell, run the following command in an elevated session ("Run as Administrator" on Windows, or with superuser privileges on macOS or Linux):

Install-Module -Name Az -AllowClobber

管理者特権へのアクセス許可がない場合は、-Scope 引数を追加することで、現在のユーザーに対してインストールできます。If you don't have access to administrator privileges, you can install for the current user by adding the -Scope argument.

Install-Module -Name Az -AllowClobber -Scope CurrentUser

既定では、PowerShell ギャラリーは、PowerShellGet の信頼できるリポジトリとしては構成されません。By default, the PowerShell gallery isn't configured as a trusted repository for PowerShellGet. PSGallery の初回使用時には、次のプロンプトが表示されます。The first time you use the PSGallery you see the following prompt:

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 を選択します。Answer Yes or Yes to All to continue with the installation.

Az モジュールは、Azure PowerShell コマンドレットのロールアップ モジュールです。The Az module is a rollup module for the Azure PowerShell cmdlets. これをインストールすると、利用可能な Azure Resource Manager モジュールがすべてダウンロードされ、コマンドレットを使用できるようになります。Installing it downloads all of the available Azure Resource Manager modules, and makes their cmdlets available for use.

サインインSign in

Azure PowerShell を使用して作業を開始するには、Azure の資格情報を使用してサインインします。To start working with Azure PowerShell, sign in with your Azure credentials.

# Connect to Azure with a browser sign in token
Connect-AzAccount

注意

モジュールの自動読み込みを無効にしている場合は、Import-Module Az を使用してモジュールを手動でインポートする必要があります。If you've disabled module autoloading, you need to manually import the module with Import-Module Az. モジュールが構造化されているため、これには数秒かかることがあります。Because of the way the module is structured, this can take a few seconds.

新しい PowerShell セッションを開始するたびに、この手順を繰り返す必要があります。You'll need to repeat these steps for every new PowerShell session you start. Azure サインインを PowerShell セッション間で維持する方法については、「PowerShell セッション間でユーザーの資格情報を保持する」をご覧ください。To learn how to persist your Azure sign-in across PowerShell sessions, see Persist user credentials across PowerShell sessions.

Azure PowerShell モジュールの更新Update the Azure PowerShell module

Azure PowerShell のインストールを更新するには、Update-Module を実行します。You can update your Azure PowerShell installation by running Update-Module. このコマンドでは、以前のバージョンはアンインストール__されません__。This command does not uninstall older versions.

Update-Module -Name Az

以前のバージョンの Azure PowerShell をシステムから削除する方法については、「Uninstall the Azure PowerShell module (Azure PowerShell モジュールのアンインストール)」をご覧ください。To learn how to remove old versions of Azure PowerShell from your system, see Uninstall the Azure PowerShell module.

複数のバージョンの Azure PowerShell の使用Use multiple versions of Azure PowerShell

複数のバージョンの Azure PowerShell をインストールできます。It's possible to install more than one version of Azure PowerShell. 複数のバージョンの Azure PowerShell がインストールされているかどうかを確認するには、次のコマンドを使用します。To check if you have multiple versions of Azure PowerShell installed, use the following command:

Get-InstalledModule -Name Az -AllVersions | select Name,Version

Azure PowerShell のバージョンを削除するには、「Azure PowerShell モジュールのアンインストール」を参照してください。To remove a version of Azure PowerShell, see Uninstall the Azure PowerShell module.

特定のバージョンの Az モジュールをインストールしたり読み込んだりするには、-RequiredVersion 引数を使用できます。You can install or load a specific version of the Az module by using the -RequiredVersion argument:

# Install Az version 0.7.0
Install-Module -Name Az -RequiredVersion 0.7.0 
# Load Az version 0.7.0
Import-Module -Name Az -RequiredVersion 0.7.0

複数のバージョンのモジュールがインストールされている場合は、モジュールが自動的に読み込まれ、Import-Module によって、既定で最新バージョンが読み込まれます。If you have more than one version of the module installed, module autoload and Import-Module load the latest version by default.

フィードバックの提供Provide feedback

Azure Powershell にバグが見つかった場合は、GitHub で問題を報告してください。If you find a bug in Azure Powershell, file an issue on GitHub. コマンド ラインからフィードバックを送るには、Send-Feedback コマンドレットを使用します。To provide feedback from the command line, use the Send-Feedback cmdlet.

次の手順Next Steps

Azure PowerShell のモジュールとその機能の詳細については、「Get started with Azure PowerShell (Azure PowerShell の概要)」をご覧ください。To learn more about the Azure PowerShell modules and their features, see Get Started with Azure PowerShell. Azure PowerShell に精通していて、AzureRM から移行する必要がある場合は、AzureRM から Az への移行に関するページを参照してください。If you're familiar with Azure PowerShell and need to migrate from AzureRM, see Migrate from AzureRM to Az.