Установка модуля Azure Az PowerShell

Статья рассказывает, как установить модуль Azure Az PowerShell из коллекции PowerShell. Эти инструкции применимы для платформ Windows, Linux и macOS.

Модуль Azure Az PowerShell предварительно установлен в Azure Cloud Shell и образах Docker.

Модуль Azure Az PowerShell является модулем свертки. Во время его установки скачиваются общедоступные модули Az PowerShell, а после этого становятся доступными соответствующие командлеты.

Требования

Примечание

Для работы с модулем Azure Az PowerShell на всех платформах мы рекомендуем использовать PowerShell 7.0.6 LTS, PowerShell 7.1.3 и выше.

Дополнительных требований для использования PowerShell 7.0.6 LTS, PowerShell 7.1.3 и выше нет.

Чтобы проверить версию PowerShell, выполните следующую команду в сеансе PowerShell:

$PSVersionTable.PSVersion

В качестве политики выполнения скриптов PowerShell нужно указать удаленно подписанную (RemoteSigned) или менее строгую политику. Вы можете определить текущую политику выполнения с помощью Get-ExecutionPolicy -List. Подробнее см. в разделе about_Execution_Policies.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Установка

Использование командлета Install-Module является предпочтительным методом установки модуля Az PowerShell. Установите модуль Az только для текущего пользователя. Это рекомендуемая область установки. Этот метод работает одинаково на платформах Windows, Linux и macOS. Выполните следующую команду из сеанса PowerShell:

Install-Module -Name Az -Scope CurrentUser -Repository PSGallery -Force

Другие варианты установки

Хотя PowerShell 7.0.6 LTS, PowerShell 7.1.3 и выше является рекомендуемой версией PowerShell, а Install-Module — рекомендуемым вариантом установки, при необходимости можно использовать и другие варианты.

Установка в Windows PowerShell

Важно!

Если у вас установлен модуль AzureRM PowerShell, то прежде чем продолжить, ознакомьтесь с разделом Сосуществование Az и AzureRM.

Модуль Azure Az PowerShell также можно использовать с PowerShell 5.1 в Windows. Чтобы использовать модуль Azure Az PowerShell в PowerShell 5.1 в Windows:

  1. Выполните обновление до Windows PowerShell 5.1. Если вы используете Windows 10 версии 1607 и выше, у вас уже есть PowerShell версии 5.1.
  2. Установите платформу .NET Framework версии 4.7.2 или более поздней.
  3. Убедитесь, что у вас установлена последняя версия PowerShellGet. Выполните Install-Module -Name PowerShellGet -Force.

Автономная установка

В некоторых средах невозможно подключиться к коллекции PowerShell. В таких случаях все же можно установить модуль Az PowerShell в автономном режиме, используя один из следующих методов:

  • Скачайте Azure PowerShell MSI. Помните, что установщик MSI работает только с PowerShell 5.1 в Windows.
  • Скачайте модули в другое сетевое расположение и используйте его в качестве источника установки. Так вы сможете кэшировать модули PowerShell на отдельном сервере или в общей папке, чтобы развернуть их с помощью PowerShellGet в любой системе в автономном режиме. Сведения о том, как настроить локальный репозиторий и установить его в системах без подключения к сети, см. в статье Работа с локальными хранилищами PowerShellGet.
  • С помощью командлета Save-Module сохраните модуль в общую папку или другой источник и вручную скопируйте на другие компьютеры.

Вход

Чтобы начать работу с Azure PowerShell, выполните вход, используя данные своей учетной записи в Azure.

Connect-AzAccount

После выполнения этой команды откроется новое окно браузера, и вы сможете войти в учетную запись Azure.

Обновление модуля Azure PowerShell

Для обновления любого модуля PowerShell следует использовать тот же метод, который использовался для установки модуля. Например, если вы изначально использовали Install-Module, для получения последней версии следует использовать командлет Update-Module. Если вы изначально использовали пакет MSI, вам нужно скачать и установить новый пакет MSI.

Командлеты PowerShellGet не могут обновлять модули, установленные из пакета MSI. Пакеты MSI не обновляют модули, установленные с помощью PowerShellGet. Если у вас возникли проблемы с обновлением с помощью модуля PowerShellGet, необходимо выполнить повторную установку, а не просто обновление. Повторная установка выполняется так же, как и первоначальная. Убедитесь, что параметр Force используется вместе с Install-Module при переустановке.

В отличие от установки с помощью MSI, при установке или обновлении с помощью PowerShellGet не удаляются более старые версии, которые могут существовать в вашей системе.

Примечание

Операция удаления может усложниться, если у вас установлено несколько версий модуля Az PowerShell. Из-за этого мы поддерживаем удаление только всех установленных в текущий момент версий модуля Az PowerShell.

Сведения о том, как удалить из системы все версии модуля Az PowerShell, см. в статье Удаление модуля Azure PowerShell. См. сведения об установке Azure PowerShell с помощью MSI.

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

Устраните неполадки при установке модуля Azure Az PowerShell.

Отзывы

Если вы нашли ошибку при работе с модулем Azure Az PowerShell, сообщите о проблеме в GitHub. Чтобы оставить отзыв в сеансе PowerShell, используйте командлет Send-Feedback.

Next Steps

Дополнительные сведения о модулях Azure Az PowerShell и их возможностях см. в статье Начало работы с Azure PowerShell. Если вы знакомы с Azure PowerShell и вам необходимо мигрировать из AzureRM, см. статью Migrate from AzureRM to Az (Миграция с AzureRM на Az).