Знакомство с модулем 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, пока вы не ознакомитесь с новым набором команд. Дополнительные сведения см. в следующем разделе или в статье Перенос 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. Чтобы автоматически обновить скрипты, следуйте инструкциям из этого краткого руководства.

сбор данных

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

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