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

Знакомство с модулем 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. Удаление модуля Azure PowerShell AzureRM
  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. Вы также можете ознакомиться с нашим заявлением о конфиденциальности , чтобы узнать больше.