Get-AzConfig
Obtém as configurações do Azure PowerShell.
Sintaxe
Get-AzConfig
[-AppliesTo <String>]
[-Scope <ConfigScope>]
[-DefaultProfile <IAzureContextContainer>]
[-CheckForUpgrade]
[-DefaultSubscriptionForLogin]
[-DisableErrorRecordsPersistence]
[-DisableInstanceDiscovery]
[-DisplayBreakingChangeWarning]
[-DisplayRegionIdentified]
[-DisplaySurveyMessage]
[-EnableDataCollection]
[-EnableLoginByWam]
[<CommonParameters>] Description
Obtém as configurações do Azure PowerShell. Por padrão, ele lista todas as configurações. Você pode filtrar o resultado usando vários parâmetros.
Observação
As configurações têm prioridades. De modo geral, o escopo do processo tem prioridade mais alta do que o escopo CurrentUser; uma configuração que se aplica a um determinado cmdlet tem prioridade mais alta do que a que se aplica a um módulo, novamente maior que Az.
Para reduzir a confusão, o resultado de Get-AzConfig mostra as configurações que estão entrando em vigor. É uma combinação de todas as configurações, mas não literalmente todas as configurações. No entanto, você sempre pode exibi-los aplicando diferentes parâmetros de filtro, como -Scope.
Exemplos
Exemplo 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, …Obtém todas as configurações.
Exemplo 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…Obtém a configuração "EnableDataCollection".
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 as configurações, o padrão é todos os itens acima; ao atualizar, o padrão é "Az".
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | 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: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.
| Tipo: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DefaultSubscriptionForLogin
Nome da assinatura ou GUID. Define o contexto padrão do Azure PowerShell ao fazer logon sem especificar uma assinatura.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DisableErrorRecordsPersistence
Quando desabilitado, os registros de erro não serão gravados em ~/. Azure/ErrorRecords. Essa configuração será substituída por "EnableErrorRecordsPersistence" como opção na próxima versão principal do Az por volta de novembro de 2023.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DisableInstanceDiscovery
Defina-o como true para desabilitar a descoberta de instâncias 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 https://login.microsoft.com/ autoridade 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: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DisplayBreakingChangeWarning
Controla se as mensagens de aviso para alterações significativas são exibidas ou suprimidas. Quando habilitado, um aviso de alteração significativa é exibido ao executar cmdlets com alterações significativas em uma versão futura.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DisplayRegionIdentified
Quando habilitado, o Azure PowerShell exibe recomendações sobre regiões que podem reduzir seus custos.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DisplaySecretsWarning
Quando habilitado, 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: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | 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: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-EnableDataCollection
Quando habilitados, os cmdlets do Azure PowerShell enviam dados de telemetria para a Microsoft para melhorar a experiência do cliente. Para obter mais informações, consulte nossa declaração de privacidade: https://aka.ms/privacy
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-EnableLoginByWam
[Visualização] Quando habilitado, o WAM (Gerenciador de Contas da Web) será a experiência de login interativa padrão. Ele voltará a usar o navegador se a plataforma não suportar WAM. Observe que esse recurso está em versão prévia. No momento, não há suporte para a MSA (Conta Microsoft). Sinta-se à vontade para entrar em contato com a equipe do Azure PowerShell se tiver algum comentário: https://aka.ms/azpsissue
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | 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 aceitos: | CurrentUser, Process, Default, Environment |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
Entradas
None