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

Update-AzConfig

Модуль:
Az.Accounts Module

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

Синтаксис

Default (по умолчанию) 

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
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-CheckForUpgrade

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

Свойства параметра

Тип:Boolean
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Confirm

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DefaultProfile

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

Свойства параметра

Тип:IAzureContextContainer
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DefaultSubscriptionForLogin

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-DisableInstanceDiscovery

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

Свойства параметра

Тип:Boolean
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-DisplayBreakingChangeWarning

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

Свойства параметра

Тип:Boolean
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-DisplayRegionIdentified

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

Свойства параметра

Тип:Boolean
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-DisplaySecretsWarning

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

Свойства параметра

Тип:Boolean
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-DisplaySurveyMessage

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

Свойства параметра

Тип:Boolean
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-EnableDataCollection

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

Свойства параметра

Тип:Boolean
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-EnableErrorRecordsPersistence

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

Свойства параметра

Тип:Boolean
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-EnableLoginByWam

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

Свойства параметра

Тип:Boolean
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-LoginExperienceV2

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

Свойства параметра

Тип:LoginExperienceConfig
Default value:None
Допустимые значения:On, Off
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Scope

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

Свойства параметра

Тип:ConfigScope
Default value:None
Допустимые значения:CurrentUser, Process, Default, Environment
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-WhatIf

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

Boolean

String

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

PSConfig