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


Знакомство с модулем 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 можно использовать с одним из следующих методов:

Features

Модуль 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. Корпорация Майкрософт Azure PowerShell не собирает частные или персональные данные. Например, данные об использовании помогают выявить такие проблемы, как командлеты с низким успехом и помочь определить приоритеты нашей работы.

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