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

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

  • Last updated on