Установка модуля Azure PowerShellInstall the Azure PowerShell module

В этой статье рассказывается, как установить модули Azure PowerShell с помощью PowerShellGet.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 работает с PowerShell 5.1 или более поздней версии на платформе Windows или с PowerShell Core 6.x или более поздней версии на любых платформах.Azure PowerShell works with PowerShell 5.1 or higher on Windows, or PowerShell Core 6.x and later on all platforms. Если вы не уверены, установлена ли среда PowerShell, либо используете macOS или Linux, установите последнюю версию PowerShell Core.If you aren't sure if you have PowerShell, or are on macOS or Linux, install the latest version of PowerShell Core.

Чтобы узнать вашу версию PowerShell, выполните приведенную ниже команду:To check your PowerShell version, run the command:

$PSVersionTable.PSVersion

Чтобы запустить Azure PowerShell в PowerShell 5.1 на платформе Windows, сделайте следующее:To run Azure PowerShell in PowerShell 5.1 on Windows:

  1. При необходимости выполните обновление до Windows PowerShell 5.1.Update to Windows PowerShell 5.1 if needed. Если вы используете Windows 10, среда PowerShell 5.1 уже установлена.If you're on Windows 10, you already have PowerShell 5.1 installed.
  2. Установите платформу .NET Framework версии 4.7.2 или более поздней.Install .NET Framework 4.7.2 or later.

При использовании PowerShell Core для Azure PowerShell нет дополнительных требований.There are no additional requirements for Azure PowerShell when using PowerShell Core.

Установка модуля Azure PowerShellInstall the Azure PowerShell module

Предупреждение

Для PowerShell 5.1 в Windows не могут одновременно быть установлены модули AzureRM и Az.You can't have both the AzureRM and Az modules installed for PowerShell 5.1 for Windows at the same time. Если в системе нужно оставить модуль AzureRM, установите модуль Az для PowerShell Core версии 6.x или более поздней.If you need to keep AzureRM available on your system, install the Az module for PowerShell Core 6.x or later. Чтобы сделать это, установите PowerShell Core версии 6.x или более поздней, а затем следуйте инструкциям в окне терминала PowerShell Core.To do this, install PowerShell Core 6.x or later and then follow these instructions in a PowerShell Core terminal.

Чтобы установить модули в глобальной области видимости, необходим более высокий уровень привилегий для установки модулей из коллекции 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.

Устранение неполадокTroubleshooting

Ниже описаны некоторые распространенные проблемы с установкой модуля Azure PowerShell.Here are some common problems seen when installing the Azure PowerShell module. Если у вас возникла проблема, не описанная здесь, сообщите о ней на сайте GitHub.If you experience a problem not listed here, please file an issue on GitHub.

Прокси-сервер блокирует подключенияProxy blocks connection

Если командлет Install-Module возвращает ошибки о том, что коллекция PowerShell недоступна, возможно, ваша система находится за прокси-сервером.If you get errors from Install-Module that indicate the PowerShell Gallery is unreachable, you may be behind a proxy. Требования к настройке прокси-сервера на уровне системы в разных операционных системах могут отличаться. Эти требования не рассматриваются здесь.Different operating systems will have different requirements for configuring a system-wide proxy, which are not covered in detail here. Обратитесь к системному администратору, чтобы узнать о параметрах своего прокси-сервера и о том, как настроить их для своей операционной системы.Contact your system administrator for your proxy settings and how to configure them for your OS.

Возможно, среду PowerShell нельзя настроить для автоматического использования этого прокси-сервера.PowerShell itself may not be configured to use this proxy automatically. В PowerShell версии 5.1 и более поздних настройте использование прокси-сервера для сеанса PowerShell с помощью следующей команды:With PowerShell 5.1 and later, configure the proxy to use for a PowerShell session with the following command:

(New-Object System.Net.WebClient).Proxy.Credentials = `
  [System.Net.CredentialCache]::DefaultNetworkCredentials

Если учетные данные операционной системы настроены правильно, в результате выполнения приведенной выше команды запросы PowerShell будут направляться через прокси-сервер.If your operating system credentials are configured correctly, this will route PowerShell requests through the proxy. Чтобы эта настройка сохранялась между сеансами, добавьте команду в профиль PowerShell.In order to have this setting persist between sessions, add the command to a PowerShell profile.

Чтобы установить пакет, ваш прокси-сервер должен разрешать HTTPS-подключения по следующему адресу:In order to install the package, your proxy needs to allow HTTPS connections to the following address:

  • https://www.powershellgallery.com

Вход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 PowerShellUpdate the Azure PowerShell module

Команда Update-Module не обновит установку надлежащим образом из-за способа упаковки модуля Az.Because of how the Az module is packaged, the Update-Module command won't update your installation correctly. С технической точки зрения Az является метамодулем, включающим все подмодули, содержащие командлеты, необходимые для взаимодействия со службами Azure.Az is technically a meta-module, encompassing all of the submodules that contain cmdlets to interact with Azure services. Это означает, что для обновления модуля Azure PowerShell его необходимо переустановить, а не просто выполнить обновление.That means that to update the Azure PowerShell module, you will need to reinstall, rather than just update. Эта процедура ничем не отличается от установки, но может потребоваться добавить аргумент -Force:This is done in the same way as installing, but you may need to add the -Force argument:

Install-Module -Name Az -AllowClobber -Force

Хотя это может перезаписать установленные модули, в системе по-прежнему могут остаться более старые версии.Although this can overwrite installed modules, you may still have older versions left on your system. Сведения о том, как удалить из системы предыдущие версии 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 PowerShellUse 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, см. статью Migrate from AzureRM to Az (Миграция с AzureRM на Az).If you're familiar with Azure PowerShell and need to migrate from AzureRM, see Migrate from AzureRM to Az.