Update-AzConfig

Ссылка

Модуль:: Az.Accounts

Обновляет конфигурации Azure PowerShell.

Синтаксис

Update-AzConfig
      [-AppliesTo <String>]
      [-Scope <ConfigScope>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [-CheckForUpgrade <Boolean>]
      [-DefaultSubscriptionForLogin <String>]
      [-DisableInstanceDiscovery <Boolean>]
      [-DisplayBreakingChangeWarning <Boolean>]
      [-DisplayRegionIdentified <Boolean>]
      [-DisplaySecretsWarning <Boolean>]
      [-DisplaySurveyMessage <Boolean>]
      [-EnableDataCollection <Boolean>]
      [-EnableErrorRecordsPersistence <Boolean>]
      [-EnableLoginByWam <Boolean>]
      [<CommonParameters>]

Описание

Обновляет конфигурации Azure PowerShell. В зависимости от того, к какой конфигурации необходимо обновить, можно указать область, к которой хранится конфигурация, и к какой модуле или командлету он применяется.

Заметка

Не рекомендуется обновлять конфигурации в нескольких процессах PowerShell. Либо сделайте это в одном процессе, либо убедитесь, что обновления находятся в области процесса (-Scope Process), чтобы избежать непредвиденных побочных эффектов.

Примеры

Пример 1

Update-AzConfig -DefaultSubscriptionForLogin "Name of subscription"

Key                         Value                Applies To Scope       Help Message
---                         -----                ---------- -----       ------------
DefaultSubscriptionForLogin Name of subscription Az         CurrentUser Subscription name or GUID. Sets the default context for Azure PowerShell when lo…

Задает конфигурацию DefaultSubscriptionForLogin в качестве имени подписки. Если Connect-AzAccount указанную подписку будет выбрана в качестве подписки по умолчанию.

Пример 2

Update-AzConfig -DisplayBreakingChangeWarning $false -AppliesTo "Az.KeyVault"

Key                          Value Applies To  Scope       Help Message
---                          ----- ----------  -----       ------------
DisplayBreakingChangeWarning False Az.KeyVault CurrentUser Controls if warning messages for breaking changes are displayed or suppressed. When enabled,…

Задает конфигурацию DisplayBreakingChangeWarnings как "$false" для модуля Az.KeyVault. Это предотвращает запрос всех предупреждающих сообщений о предстоящих критических изменениях в модуле Az.KeyVault.

Пример 3

Update-AzConfig -EnableDataCollection $true

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

Задает конфигурацию EnableDataCollection как "$true". Это позволяет отправлять данные телеметрии. Установка этой конфигурации эквивалентна Enable-AzDataCollection и Disable-AzDataCollection.

Пример 4

Update-AzConfig -DisplaySecretsWarning $true

Key                   Value Applies To Scope       Help Message
---                   ----- ---------- -----       ------------
DisplaySecretsWarning True  Az         CurrentUser When enabled, a warning message for secrets redaction will be displ…

Задает конфигурацию DisplaySecretsWarning как "$true". Это позволяет обнаружить секреты во время выполнения командлета и отобразить предупреждение, если в выходных данных обнаружены какие-либо секреты.

Параметры

-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.

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

-Confirm

Запрашивает подтверждение перед запуском командлета.

Тип:	SwitchParameter
Aliases:	cf
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 при входе в систему без указания подписки.

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

-DisableInstanceDiscovery

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

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

-DisplayBreakingChangeWarning

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

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

-DisplayRegionIdentified

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

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

-DisplaySecretsWarning

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

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

-DisplaySurveyMessage

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

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

-EnableDataCollection

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

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

-EnableErrorRecordsPersistence

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

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

-EnableLoginByWam

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

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

-LoginExperienceV2

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

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

-Scope

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

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

-WhatIf

Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.

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

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

Boolean

String

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

PSConfig

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