Azure PowerShell предлагает различные глобальные параметры, такие как возможность отключения сообщений предупреждения о критических изменениях. До версии 9 модуля Az PowerShell не было централизованного или подробного метода настройки этих глобальных параметров.
Централизованная конфигурация
Модуль Az PowerShell версии 9 и выше включает командлеты для управления конфигурацией глобальных параметров для Azure PowerShell. Эти *-AzConfig командлеты являются частью модуля Az.Accounts PowerShell:
Вы можете применить параметры, действующие в определенной области. Допустимые значения параметра Scope :
Current User: область по умолчанию при применении параметра.
Process: параметр применяется только к текущему сеансу PowerShell.
Default: область только для чтения, в которой значение по умолчанию не изменилось.
Environment: область только для чтения, в которой значение настраивается с помощью переменной среды.
Кроме областей, можно применять параметры ко всем модулям Az PowerShell или только одному модулю.
С помощью параметра AppliesTo можно указать, насколько широко применяется параметр. Значение Az указывает, что параметр применяется ко всем модулям, которые являются частью Azure PowerShell.
Варианты конфигурации
Существует множество параметров конфигурации, которые можно задать с *-AzConfig помощью командлетов. Многие из этих параметров конфигурации показаны в этом разделе. Выполните следующую команду, чтобы просмотреть полный список параметров конфигурации Azure PowerShell, которые можно задать с *-AzConfig помощью командлетов.
Azure PowerShell
Get-AzConfig | Format-List
Уведомления об обновлении
Уведомления об обновлениях версий Azure PowerShell — это функция, выпущенная в модуле Az PowerShell версии 10.3.0. Когда доступна новая версия Azure PowerShell, в интерактивном сеансе PowerShell отображается уведомление об обновлении.
Чтобы определить, включены ли уведомления об обновлении, используйте Get-AzConfig командлет с параметром CheckForUpgrade , как показано в следующем примере.
Azure PowerShell
Get-AzConfig -CheckForUpgrade
Чтобы включить уведомления об обновлении для Azure PowerShell, используйте Update-AzConfig командлет с параметром CheckForUpgrade и $true его значением, как показано в следующем примере.
Azure PowerShell
Update-AzConfig -CheckForUpgrade$true
Чтобы отключить уведомления об обновлении, используйте Update-AzConfig командлет с параметром CheckForUpgrade и $false его значением, как показано в следующем примере.
Azure PowerShell
Update-AzConfig -CheckForUpgrade$false
Подписка по умолчанию
По умолчанию, начиная с модуля Az PowerShell версии 12.0.0, если у вас есть доступ к нескольким подпискам, вам будет предложено выбрать подписку Azure для входа с помощью.
Чтобы запретить выбор подписки при каждом входе в систему, используйте Update-AzConfig командлет с параметром DefaultSubscriptionForLogin , чтобы задать подписку по умолчанию, как показано в следующем примере.
Azure PowerShell
Update-AzConfig -DefaultSubscriptionForLogin <Subscription ID or Name>
Примечание
Не следует путать с подпиской контекста по умолчанию, конфигурация DefaultSubscriptionForLogin действует только при проверке подлинности в Azure.
Обнаружение экземпляров
Параметр обнаружения экземпляров отключен для ситуаций, когда конечная точка метаданных недоступна, например в частных облаках или средах Azure Stack. Обнаружение экземпляров включает получение метаданных центра для https://login.microsoft.com/ проверки центра. Включив этот параметр (задав его true), отключите как обнаружение экземпляров, так и проверку центра. Поэтому важно убедиться, что настроенный узел центра является допустимым и надежным.
Чтобы отключить обнаружение экземпляров и проверку центра, включите этот параметр (задайте для него значение true).
Azure PowerShell
Update-AzConfig -DisableInstanceDiscovery$true
Предупреждающие сообщения о критических изменениях
Чтобы отключить предупреждения о критическом изменении для командлетов во всех модулях Az , используйте Update-AzConfig командлет с DisplayBreakingChangeWarning параметром, как показано в следующем примере:
Чтобы отключить предупреждение о критическом изменении специально для командлетов в модуле Az.Compute , используйте Update-AzConfig командлет с параметрами DisplayBreakingChangeWarning и AppliesTo , как показано в следующем примере:
В этом сценарии предупреждение о критическом изменении остается активным для командлетов во всех модулях Az PowerShell, кроме Az.Compute.
Идентификация региона Azure
Клиенты Azure могут развертывать ресурсы в нескольких разных регионах. Иногда клиенты могут сократить затраты, выбрав ближайшие регионы, предлагающие те же услуги. Если определен ближайший регион, отобразится сообщение, которое будет выбрано для будущих развертываний.
Чтобы отключить сообщения рекомендаций по регионам, используйте Update-AzConfig командлет с параметром DisplayRegionIdentified , как показано в следующем примере.
Azure PowerShell отображает предупреждающее сообщение по умолчанию, начиная с версии 12.0.0, чтобы защитить конфиденциальную информацию при определении потенциального секрета в выходных данных команды.
В следующем примере Update-AzConfig командлет используется для отключения предупреждения.
Azure PowerShell
Update-AzConfig -DisplaySecretsWarning$false
Опросы
При использовании Azure PowerShell вам может быть предложено принять участие в опросе, чтобы рассказать нам о вашем опыте. Хотя для нас важно получать эти ценные сведения, мы также понимаем, что не все хотят видеть предложение о прохождении опроса.
Вы можете отключить участие в опросах с помощью командлета Update-AzConfig , как показано в следующем примере.
Azure PowerShell
Update-AzConfig -DisplaySurveyMessage$false
сбор данных
По умолчанию командлеты Azure PowerShell отправляют данные телеметрии в корпорацию Майкрософт, чтобы улучшить взаимодействие с клиентами. Дополнительные сведения см. в нашем заявлении о конфиденциальности: aka.ms/privacy.
Azure PowerShell
Update-AzConfig -EnableDataCollection$false
Записи об ошибках
По умолчанию записи об ошибках Azure PowerShell записываются $HOME/.Azure/ErrorRecordsв .
Чтобы отключить записи постоянных ошибок, используйте Update-AzConfig командлет с параметром EnableErrorRecordsPersistence , как показано в следующем примере.
Начиная с модуля 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.
Azure PowerShell
Update-AzConfig -EnableLoginByWam$false
Новый интерфейс входа
Начиная с модуля Az PowerShell версии 12.0.0, если у вас есть доступ к нескольким подпискам, вам будет предложено выбрать подписку Azure для входа с помощью.
Если новый интерфейс входа отключен и у вас есть доступ к нескольким подпискам, вы войдете в первую подписку Azure, если только вы не указали подписку.Connect-AzAccount Команды выполняются по умолчанию для этой подписки. Это поведение может быть опасным, например если первая возвращенная подписка является рабочей средой.
Чтобы отключить новый интерфейс входа, используйте Update-AzConfig командлет, как показано в следующем примере.
Azure PowerShell
Update-AzConfig -LoginExperienceV2 Off
Параметры репликации
Чтобы реплицировать параметры из одной среды в другую, используйте Export-AzConfig командлет для экспорта параметров в JSON-файл.
Azure PowerShell
Export-AzConfig -Path$HOME\AzConfig.json
Чтобы импортировать параметры, используйте Import-AzConfig командлет и найдите ранее экспортируемый JSON-файл.
Azure PowerShell
Import-AzConfig -Path$HOME\AzConfig.json
Настройка очистки
Чтобы сбросить параметр конфигурации одного или нескольких глобальных параметров Azure PowerShell по умолчанию, используйте Clear-AzConfig командлет. В следующем примере параметр DefaultSubscriptionForLogin очищается.
Azure PowerShell
Clear-AzConfig -DefaultSubscriptionForLogin
Совместная работа с нами на GitHub
Источник этого содержимого можно найти на GitHub, где также можно создавать и просматривать проблемы и запросы на вытягивание. Дополнительные сведения см. в нашем руководстве для участников.
Отзыв о Azure PowerShell
Azure PowerShell — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв:
В этом модуле объясняется среда Azure PowerShell и модуль Az для Windows PowerShell. В нем также объясняется, как управлять идентификатором Microsoft Entra с помощью модулей PowerShell.