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


Get-AzConfig

Возвращает конфигурации Azure PowerShell.

Синтаксис

Get-AzConfig
   [-AppliesTo <String>]
   [-Scope <ConfigScope>]
   [-DefaultProfile <IAzureContextContainer>]
   [-CheckForUpgrade]
   [-DefaultSubscriptionForLogin]
   [-DisableInstanceDiscovery]
   [-DisplayBreakingChangeWarning]
   [-DisplayRegionIdentified]
   [-DisplaySecretsWarning]
   [-DisplaySurveyMessage]
   [-EnableDataCollection]
   [-EnableErrorRecordsPersistence]
   [-EnableLoginByWam]
   [-LoginExperienceV2]
   [<CommonParameters>]

Описание

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

Заметка

Конфигурации имеют приоритеты. Как правило, область процесса имеет более высокий приоритет, чем область CurrentUser; Конфигурация, которая применяется к определенному командлету, имеет более высокий приоритет, чем применяется к модулю, опять же выше Az. Чтобы уменьшить путаницу, результат Get-AzConfig показывает эти конфигурации, которые встраиваются в силу. Это сочетание всех конфигураций, но не буквально всех конфигураций. Однако их можно всегда просматривать, применяя различные параметры фильтра, например -Scope.

Примеры

Пример 1

Get-AzConfig

Key                           Value Applies To Scope       Help Message
---                           ----- ---------- -----       ------------
EnableDataCollection          False Az         CurrentUser When enabled, Azure PowerShell cmdlets send telemetry data to Microsoft to improve the custom…
DefaultSubscriptionForLogin         Az         Default     Subscription name or GUID. Sets the default context for Azure PowerShell when logging in with…
DisplayBreakingChangeWarning  True  Az         Default     Controls if warning messages for breaking changes are displayed or suppressed. When enabled, …

Возвращает все конфигурации.

Пример 2

Get-AzConfig -EnableDataCollection

Key                           Value Applies To Scope       Help Message
---                           ----- ---------- -----       ------------
EnableDataCollection          False Az         CurrentUser When enabled, Azure PowerShell cmdlets send telemetry data to Microsoft to improve the custom…

Возвращает конфигурацию EnableDataCollection.

Параметры

-AppliesTo

Указывает, к какой части Azure PowerShell применяется конфигурация. Возможные значения:

  • Az: конфигурация применяется ко всем модулям и командлетам Azure PowerShell.
  • Имя модуля: конфигурация применяется к определенному модулю Azure PowerShell. Например, Az.Storage.
  • Имя командлета: конфигурация применяется к определенному командлету Azure PowerShell. Например, Get-AzKeyVault. Если он не указан, при получении или очистке конфигураций по умолчанию используется для всех указанных выше значений; при обновлении значение по умолчанию — Az.
Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-CheckForUpgrade

При включении Azure PowerShell автоматически проверяет наличие обновлений и отображает сообщение подсказки при доступности обновления. Значение по умолчанию — true.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для взаимодействия с Azure.

Тип:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DefaultSubscriptionForLogin

Имя подписки или GUID. Задает контекст по умолчанию для Azure PowerShell при входе в систему без указания подписки.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisableInstanceDiscovery

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisplayBreakingChangeWarning

Определяет, отображаются ли или подавляются предупреждения о критических изменениях. При включении при выполнении командлетов с критическими изменениями в будущем выпуске отображается предупреждение о критическом изменении.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisplayRegionIdentified

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisplaySecretsWarning

Если этот параметр включен, появится предупреждение, когда выходные данные командлета содержат секреты. Дополнительные сведения см. в https://go.microsoft.com/fwlink/?linkid=2258844

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisplaySurveyMessage

При включении вам предлагается редко участвовать в опросах взаимодействия с пользователями для Azure PowerShell.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-EnableDataCollection

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-EnableErrorRecordsPersistence

При включении записи об ошибках записываются в ~/. Azure/ErrorRecords.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-EnableLoginByWam

[предварительная версия] При включении диспетчер веб-учетных записей (WAM) будет интерактивным интерфейсом входа по умолчанию. Он вернется к использованию браузера, если платформа не поддерживает WAM. Обратите внимание, что эта функция находится в предварительной версии. Учетная запись Майкрософт (MSA) в настоящее время не поддерживается. Вы можете обратиться к команде Azure PowerShell, если у вас есть отзывы: https://aka.ms/azpsissue

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-LoginExperienceV2

Только при интерактивной проверке подлинности пользователь может выбрать подписку и клиент, используемые в последующих командах. Возможные значения объявления "Вкл. (По умолчанию) и "Выкл.". Для параметра On требуются входные данные пользователя. Функция Off будет использовать первый клиент и подписку, возвращаемую Azure, может изменяться без уведомления и привести к выполнению команд в нежелательном контексте (не рекомендуется).

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Scope

Определяет область изменений конфигурации, например, применяются ли изменения только к текущему процессу или ко всем сеансам, запущенным этим пользователем. По умолчанию это CurrentUser.

Тип:ConfigScope
Допустимые значения:CurrentUser, Process, Default, Environment
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

None

Выходные данные

PSConfig