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

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

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

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

• Get-AzConfig
• Update-AzConfig
• Export-AzConfig
• Import-AzConfig
• Clear-AzConfig

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

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

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

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

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

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

Get-AzConfig | Format-List

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

Уведомления об обновлениях версий Azure PowerShell — это функция, выпущенная в модуле Az PowerShell версии 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>

Обнаружение экземпляров

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

В следующем примере 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, системы 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