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

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

  • Статья

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

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

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

Гранулярные настройки

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

  • 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

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

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

В следующем примере командлет 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)

Начиная с версии 12.0.0 модуля Az для PowerShell, системы 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

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

Начиная с версии 12.0.0 модуля Az PowerShell, если у вас есть доступ к нескольким подпискам, вам предложат выбрать подписку 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