Настройка глобальных параметров Azure PowerShell

Azure PowerShell предлагает различные глобальные параметры, такие как возможность отключения сообщений предупреждения о критических изменениях. До версии 9 модуля Az PowerShell не было централизованного или подробного метода настройки этих глобальных параметров.

Централизованная конфигурация

Модуль PowerShell Az версии 9 и более поздних включает командлеты для управления конфигурацией глобальных параметров в Azure PowerShell. Эти *-AzConfig командлеты являются частью модуля Az.Accounts в PowerShell.

Детализированные параметры

Вы можете применить параметры, действующие в определенной области. Допустимые значения параметра Scope :

  • Current User: область по умолчанию при применении параметра.
  • Process: параметр применяется только к текущему сеансу PowerShell.
  • Default: область только для чтения, в которой значение по умолчанию не изменилось.
  • Environment: область только для чтения, в которой значение настраивается с помощью переменной среды.

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

Параметры конфигурации

Существует множество параметров конфигурации, которые можно задать с помощью командлетов *-AzConfig. Многие из этих параметров конфигурации показаны в этом разделе. Выполните следующую команду, чтобы просмотреть полный список параметров конфигурации Azure PowerShell, которые можно задать с помощью командлетов *-AzConfig.

Get-AzConfig | Format-List

Уведомления об обновлении

Уведомления в инструменте об обновлениях версий Azure PowerShell — это функция, представленная в модуле PowerShell Az версии 10.3.0. Когда доступна новая версия Azure PowerShell, в интерактивном сеансе PowerShell отображается уведомление об обновлении.

Чтобы определить, включены ли уведомления об обновлении, используйте Get-AzConfig командлет с параметром CheckForUpgrade , как показано в следующем примере.

Get-AzConfig -CheckForUpgrade

Чтобы включить уведомления об обновлении для Azure PowerShell, используйте командлет Update-AzConfig с параметром CheckForUpgrade и $true для его значения, как показано в следующем примере.

Update-AzConfig -CheckForUpgrade $true

Чтобы отключить уведомления об обновлении, используйте Update-AzConfig командлет с параметром CheckForUpgrade и значением $false, как показано в следующем примере.

Update-AzConfig -CheckForUpgrade $false

Подписка по умолчанию

По умолчанию, начиная с Az модуль PowerShell версии 12.0.0. Если у вас есть доступ к нескольким подпискам, вам будет предложено выбрать подписку Azure для входа.

Чтобы предотвратить запрос выбора подписки при каждом интерактивном входе в систему, используйте командлет Update-AzConfig с параметром DefaultSubscriptionForLogin для установки подписки по умолчанию, как показано в примере ниже.

Update-AzConfig -DefaultSubscriptionForLogin <Subscription ID or Name>

Замечание

Не следует путать с подпиской контекста по умолчанию, конфигурация DefaultSubscriptionForLogin действует только при проверке подлинности в Azure.

Обнаружение инстанций

Параметр отключения обнаружения экземпляров предназначен для ситуаций, когда конечная точка метаданных недоступна, например, в частных облаках или в средах Azure Stack. Обнаружение экземпляров включает получение метаданных разрешающего органа из https://login.microsoft.com/ для проверки полномочий. Включив этот параметр (установив его в true), вы отключаете как обнаружение экземпляров, так и проверку полномочий. Поэтому важно убедиться, что настроенный узел центра является допустимым и надежным.

Чтобы отключить поиск экземпляров и валидацию полномочий, включите этот параметр (задайте для него значение true).

Update-AzConfig -DisableInstanceDiscovery $true

Предупреждения о критических изменениях

Чтобы отключить предупреждения о критических изменениях для командлетов во всех модулях Az, используйте командлет Update-AzConfig с параметром DisplayBreakingChangeWarning, как показано в примере ниже.

Update-AzConfig -DisplayBreakingChangeWarning $false

Чтобы отключить предупреждение о критических изменениях для командлетов в модуле Az.Compute, используйте командлет Update-AzConfig с параметрами DisplayBreakingChangeWarning и AppliesTo, как показано в следующем примере:

Update-AzConfig -DisplayBreakingChangeWarning $false -AppliesTo Az.Compute

В этом сценарии предупреждение о критическом изменении остается активным для командлетов во всех модулях Az PowerShell, кроме Az.Compute.

идентификация региона Azure

Azure клиенты могут развертывать ресурсы в нескольких разных регионах. Иногда клиенты могут сократить затраты, выбрав ближайшие регионы, предлагающие те же услуги. Если определен ближайший регион, отобразится сообщение о выборе региона для будущих развертываний.

Чтобы отключить сообщения рекомендаций по регионам, используйте Update-AzConfig командлет с параметром DisplayRegionIdentified , как показано в следующем примере.

Update-AzConfig -DisplayRegionIdentified $false

Дополнительные сведения о регионах Azure смотрите в разделе Выбор подходящего региона Azure для вас.

Предупреждение о показе секретов

Azure PowerShell отображает предупреждение по умолчанию, начиная с версии 12.0.0.0, чтобы защитить конфиденциальную информацию при определении потенциального секрета в выходных данных команды.

В следующем примере командлет Update-AzConfig используется для отключения предупреждающего сообщения.

Update-AzConfig -DisplaySecretsWarning $false

Опросы

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

Вы можете отключить запросы на участие в опросах с помощью командлета Update-AzConfig, как показано в следующем примере.

Update-AzConfig -DisplaySurveyMessage $false

Сбор данных

По умолчанию командлеты Azure PowerShell отправляют данные телеметрии Майкрософт для улучшения взаимодействия с клиентами. Дополнительные сведения см. в нашем заявлении о конфиденциальности: aka.ms/privacy.

Update-AzConfig -EnableDataCollection $false

Записи об ошибках

По умолчанию записи об ошибках Azure PowerShell записываются в $HOME/.Azure/ErrorRecords.

Чтобы отключить постоянные записи ошибок, используйте Update-AzConfig командлет с параметром EnableErrorRecordsPersistence, как показано в следующем примере.

Update-AzConfig -EnableErrorRecordsPersistence $false

Менеджер веб-учетных записей (WAM)

Начиная с Az модуль PowerShell версии 12.0.0.0, системы Windows используют диспетчер веб-учетных записей (WAM), а системы Linux и macOS по умолчанию используют вход на основе браузера.

Чтобы использовать вход через браузер в Windows 10 и более поздние версии или Windows Server 2019 и более поздние версии с Az 12.0.0 и выше, необходимо отключить WAM для использования с Azure PowerShell. Используйте следующую команду, чтобы отключить WAM и вернуться к входу через браузер, значению по умолчанию до Az 12.0.0.

Update-AzConfig -EnableLoginByWam $false

Новый интерфейс входа

Начиная с Az модуль PowerShell версии 12.0.0. Если у вас есть доступ к нескольким подпискам, вам будет предложено выбрать подписку Azure для входа.

Если новый интерфейс входа отключен, и у вас есть доступ к нескольким подпискам, вы войдете в ту подписку, которую Azure возвращает первой, если вы не указали конкретную подписку с помощью Connect-AzAccount. Команды по умолчанию выполняются для этой подписки. Это поведение может быть опасным, например, если первая возвращенная подписка является продуктивной средой.

Как показано в следующем примере, чтобы отключить новый интерфейс входа, используйте командлет Update-AzConfig.

Update-AzConfig -LoginExperienceV2 Off

Параметры репликации

Чтобы реплицировать параметры из одной среды в другую, используйте Export-AzConfig командлет для экспорта параметров в JSON-файл.

Export-AzConfig -Path $HOME\AzConfig.json

Чтобы импортировать параметры, используйте Import-AzConfig командлет и найдите ранее экспортируемый JSON-файл.

Import-AzConfig -Path $HOME\AzConfig.json

Настройка очистки

Чтобы сбросить настройку конфигурации одного или нескольких глобальных параметров Azure PowerShell на значения по умолчанию, используйте командлет Clear-AzConfig. В следующем примере параметр DefaultSubscriptionForLogin очищается.

Clear-AzConfig -DefaultSubscriptionForLogin
  • Last updated on