Update-AzConfig
Atualiza as configurações do Azure PowerShell.
Sintaxe
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>] Description
Atualiza as configurações do Azure PowerShell. Dependendo de qual configuração atualizar, você pode especificar o escopo onde a configuração é persistente e a qual módulo ou cmdlet ela se aplica.
Observação
É desaconselhável atualizar configurações em vários processos do PowerShell. Faça isso em um processo ou verifique se as atualizações estão no escopo do processo (-Scope Process) para evitar efeitos colaterais inesperados.
Exemplos
Exemplo 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…Define a configuração "DefaultSubscriptionForLogin" como "Nome da assinatura". Quando Connect-AzAccount a assinatura especificada será selecionada como a assinatura padrão.
Exemplo 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,…Define a configuração "DisplayBreakingChangeWarnings" como "$false" para o módulo "Az.KeyVault". Isso impede que todas as mensagens de aviso para futuras alterações de quebra no módulo Az.KeyVault sejam solicitadas.
Exemplo 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…Define a configuração "EnableDataCollection" como "$true". Isso permite o envio dos dados de telemetria.
Definir essa configuração é equivalente a Enable-AzDataCollection e Disable-AzDataCollection.
Exemplo 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…Define a configuração "DisplaySecretsWarning" como "$true". Isso permite a deteção de segredos durante a execução do cmdlet e exibe uma mensagem de aviso se algum segredo for encontrado na saída.
Parâmetros
-AppliesTo
Especifica a qual parte do Azure PowerShell a configuração se aplica. Os valores possíveis são:
- "Az": a configuração se aplica a todos os módulos e cmdlets do Azure PowerShell.
- Nome do módulo: a configuração se aplica a um determinado módulo do Azure PowerShell. Por exemplo, "Az.Storage".
- Nome do cmdlet: a configuração se aplica a um determinado cmdlet do Azure PowerShell. Por exemplo, "Get-AzKeyVault". Se não for especificado, ao obter ou limpar configurações, o padrão será para todos os itens acima; ao atualizar, o padrão é "Az".
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-CheckForUpgrade
Quando habilitado, o Azure PowerShell verificará se há atualizações automaticamente e exibirá uma mensagem de dica quando uma atualização estiver disponível. O valor padrão é true.
| Tipo: | Boolean |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-Confirm
Solicita confirmação antes de executar o cmdlet.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.
| Tipo: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-DefaultSubscriptionForLogin
Nome da subscrição ou GUID. Define o contexto padrão para o Azure PowerShell ao fazer logon sem especificar uma assinatura.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-DisableInstanceDiscovery
Defina-o como true para desativar a descoberta de instância e a validação de autoridade. Essa funcionalidade destina-se ao uso em cenários em que o ponto de extremidade de metadados não pode ser alcançado, como em nuvens privadas ou no Azure Stack. O processo de descoberta de instância envolve a recuperação de metadados de autoridade de https://login.microsoft.com/ para validar a autoridade. Ao definir isso como true, a validação da autoridade é desabilitada. Como resultado, é crucial garantir que o host de autoridade configurado seja válido e confiável.
| Tipo: | Boolean |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-DisplayBreakingChangeWarning
Controla se as mensagens de aviso para alterações de quebra são exibidas ou suprimidas. Quando habilitado, um aviso de alteração de quebra é exibido ao executar cmdlets com alterações de quebra em uma versão futura.
| Tipo: | Boolean |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-DisplayRegionIdentified
Quando habilitado, o Azure PowerShell exibe recomendações sobre regiões que podem reduzir seus custos.
| Tipo: | Boolean |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-DisplaySecretsWarning
Quando habilitada, uma mensagem de aviso será exibida quando a saída do cmdlet contiver segredos. Saiba mais em https://go.microsoft.com/fwlink/?linkid=2258844
| Tipo: | Boolean |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-DisplaySurveyMessage
Quando habilitado, você é solicitado com pouca frequência a participar de pesquisas de experiência do usuário para o Azure PowerShell.
| Tipo: | Boolean |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-EnableDataCollection
Quando habilitados, os cmdlets do Azure PowerShell enviam dados de telemetria para a Microsoft para melhorar a experiência do cliente. Para mais informações, consulte a nossa declaração de privacidade: https://aka.ms/privacy
| Tipo: | Boolean |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-EnableErrorRecordsPersistence
Quando ativado, os registros de erro serão gravados em ~/. Azure/ErrorRecords.
| Tipo: | Boolean |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-EnableLoginByWam
[Pré-visualização] Quando ativado, o Web Account Manager (WAM) será a experiência de login interativo padrão. Ele voltará a usar o navegador se a plataforma não suportar WAM. Observe que esse recurso está em visualização. A Conta Microsoft (MSA) não é suportada no momento. Sinta-se à vontade para entrar em contato com a equipe do Azure PowerShell se tiver algum feedback: https://aka.ms/azpsissue
| Tipo: | Boolean |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-LoginExperienceV2
Somente ativo ao autenticar interativamente, permite que o usuário escolha a assinatura e o locatário usados nos comandos subsequentes. Valores possíveis ad 'On' (Default) e 'Off'. 'On' requer a entrada do usuário. 'Off' usará o primeiro locatário e a assinatura retornada pelo Azure, pode ser alterada sem aviso prévio e levar à execução de comandos em um contexto indesejado (não recomendado).
| Tipo: | LoginExperienceConfig |
| Valores aceites: | On, Off |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-Scope
Determina o escopo das alterações de configuração, por exemplo, se as alterações se aplicam apenas ao processo atual ou a todas as sessões iniciadas por esse usuário. Por padrão, é CurrentUser.
| Tipo: | ConfigScope |
| Valores aceites: | CurrentUser, Process, Default, Environment |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
Entradas
Saídas
Azure PowerShell