Поделиться через

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

Обзор

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

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

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

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

Хотя модуль AzureRM может по-прежнему функционировать, он больше не поддерживается и не обслуживается, поэтому его дальнейшее использование осуществляется на усмотрение и риск пользователя. Пожалуйста, обратитесь к нашим ресурсам по миграции, чтобы получить рекомендации по переходу на модуль Az.

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

Функции

Модуль Az PowerShell имеет следующие преимущества:

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

Замечание

PowerShell 7.2 или более поздней версии — это рекомендуемая версия PowerShell для использования с модулем Az PowerShell на всех платформах.

Модуль Az PowerShell основан на библиотеке .NET Standard и работает с PowerShell 7.2 и более поздних версий на всех платформах, включая Windows, Linux и macOS. Он также совместим с 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 PowerShell.
  3. ДОПОЛНИТЕЛЬНО. Активируйте режим совместимости, чтобы добавить псевдонимы для командлетов AzureRM с помощью Enable-AzureRMAlias, пока вы не ознакомитесь с новым набором команд. Для получения дополнительной информации см. следующий раздел или Начните миграцию от AzureRM к Az.

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

Если скрипты по-прежнему основаны на модуле AzureRM, у нас есть несколько ресурсов, которые помогут вам выполнить миграцию:

Поддерживаемость

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

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

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

Сбор данных

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

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