Настройка глобальных параметров 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
Чтобы включить уведомления об обновлении для Azure PowerShell, используйте командлет
Update-AzConfig -CheckForUpgrade $true
Чтобы отключить уведомления об обновлении, используйте командлет
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, чтобы защитить конфиденциальную информацию при определении потенциального секрета в выходных данных команды.
В следующем примере командлет 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 модуля PowerShell Az, если у вас доступ к нескольким подпискам, вам будет предложено выбрать подписку 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
Azure PowerShell