Знакомство с модулем Azure Az PowerShell

  • Статья

Обзор

Модуль Az PowerShell — это набор командлетов для управления ресурсами Azure непосредственно из PowerShell. PowerShell предоставляет мощные возможности автоматизации, которые можно использовать для управления ресурсами Azure, например, в контексте конвейера CI/CD.

Модуль Az PowerShell является заменой AzureRM. Теперь это рекомендуемая версия для взаимодействия с Azure.

Внимание!

Так как модули PowerShell Az теперь обладают всеми возможностями модулей PowerShell AzureRM, а также многими другими, 29 февраля 2024 г. мы прекратим поддержку модулей PowerShell AzureRM.

Чтобы избежать прерываний в работе служб, обновите скрипты, использующие модули PowerShell AzureRM, для использования модулей PowerShell Az, до 29 февраля 2024 г. Чтобы автоматически обновить скрипты, следуйте инструкциям из этого краткого руководства.

Модуль Az PowerShell можно использовать с одним из следующих методов:

Компоненты

Использование модуля Az PowerShell связано с рядом преимуществ.

  • Безопасность и стабильность:
    • шифрование кэша токенов;
    • Предотвращение атак "злоумышленник в середине"
    • Поддержка проверки подлинности с помощью ADFS 2019
    • Проверка подлинности на основе имени пользователя и пароля в PowerShell 7
    • Поддержка таких функций, как непрерывная оценка доступа
  • Поддержка всех служб Azure:
    • Все общедоступные службы Azure имеют соответствующий поддерживаемый модуль PowerShell
    • исправление ряда ошибок и обновление версий API, используемых с AzureRM.
  • Новые возможности
    • поддержка в Cloud Shell и кросс-платформенных решениях;
    • возможность получения и использования маркера доступа для доступа к ресурсам Azure;
    • Командлет, доступный для дополнительных операций REST с ресурсами Azure

Примечание

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

Модуль Az PowerShell основан на библиотеке .NET Standard и работает с PowerShell 7 и более поздних версий на всех платформах, включая Windows, macOS и Linux. Он также совместим с Windows PowerShell 5.1.

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

Обновление среды до Az

Для включения поддержки новых функций Azure в PowerShell необходимо перейти на модуль Az. Если вы не готовы установить модуль Az в качестве замены AzureRM, вам доступны несколько способов экспериментирования с Az.

  • Использование среды PowerShell с Azure Cloud Shell. Azure Cloud Shell — это браузерная среда оболочки, которая поставляется с пакетом установки модуля Az и поддерживает псевдонимы совместимости Enable-AzureRM.
  • Не удаляйте модуль AzureRM, установленный в Windows PowerShell 5.1. Просто установите модуль Az в PowerShell версии 7 или выше. Windows PowerShell 5.1 и PowerShell версии 7 или выше используют разные коллекции модулей. Выполните инструкции по установке последней версии PowerShell, а затем установите модуль Az из PowerShell версии 7 или выше.

Чтобы выполнить обновление из существующей установки AzureRM, сделайте следующее:

  1. Удалите модуль AzureRM для Azure PowerShell.
  2. Установите модуль Az для Azure PowerShell.
  3. НЕОБЯЗАТЕЛЬНО. Активируйте режим совместимости, чтобы добавить псевдонимы для командлетов AzureRM с помощью Enable-AzureRMAlias, пока вы не ознакомитесь с новым набором команд. Дополнительные сведения см. в следующем разделе или в статье Перенос Azure PowerShell с AzureRM на Az.

Перенос существующих скриптов с AzureRM на Az

Если ваши скрипты зависят от модуля AzureRM, вы можете выполнить перенос с помощью нескольких ресурсов:

Возможности поддержки

Az — это актуальный модуль PowerShell для Azure. Проблемы или запросы функций можно регистрировать непосредственно в репозитории GitHub или через службу поддержки Майкрософт, если у вас есть контракт на поддержку. Запросы функций реализованы в последней версии Az. Критические проблемы реализуются в последних двух версиях Az.

Так как модули Az PowerShell теперь имеют все возможности модулей AzureRM PowerShell и многое другое, мы удалим модули AzureRM PowerShell 29 февраля 2024 г.

Чтобы избежать перебоев в работе служб, обновите сценарии , использующие модули AzureRM PowerShell, чтобы они использовали модули Az PowerShell до 29 февраля 2024 г. Чтобы автоматически обновить скрипты, следуйте инструкциям из этого краткого руководства.

Сбор данных

Azure PowerShell собирает данные телеметрии по умолчанию. Корпорация Майкрософт агрегирует собранные данные для определения закономерностей использования, обнаружения распространенных проблем и улучшения работы Azure PowerShell. Microsoft Azure PowerShell не собирает личные или персональные данные. Например, данные об использовании позволяют определить проблемы, вызванные, например, командлетами с низким процентом выполнений, и помогают задать приоритеты для нашей работы.

Хотя для нас важно получать эти ценные сведения, мы также понимаем, что не все хотят передавать данные об использовании. Сбор данных можно отключить с помощью командлета Disable-AzDataCollection. Вы также можете ознакомиться с нашим заявлением о конфиденциальности, чтобы получить дополнительные сведения.