Clear-AzConfig

Módulo:

Az.Accounts

Limpa os valores de configurações que são definidos pelo usuário.

Sintaxe

Clear-AzConfig
     [-Force]
     [-PassThru]
     [-AppliesTo <String>]
     [-Scope <ConfigScope>]
     [-DefaultProfile <IAzureContextContainer>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

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

Description

Limpa os valores de configurações que são definidos pelo usuário. Por padrão, todas as configurações serão desmarcadas. Você também pode especificar chaves de configurações para limpar.

Exemplos

Exemplo 1

Clear-AzConfig -Force

Limpe todas as configurações. -Force suprime o prompt de confirmação.

Exemplo 2

Clear-AzConfig -EnableDataCollection

Desmarque 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 configurações, ele usará como padrão todas as configurações acima; ao atualizar, ele usa como 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

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:	SwitchParameter
Aliases:	cf
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 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

-DisableInstanceDiscovery

Defina-o como true para desabilitar 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 atingido, 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 está 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 interruptivas são exibidas ou suprimidas. Quando habilitado, um aviso de alteração interruptiva é exibido ao executar cmdlets com alterações interruptivas 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 em 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 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:	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 a participar com pouca frequência 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

-EnableErrorRecordsPersistence

Quando habilitado, os registros de erro serão gravados em ~/. Azure/ErrorRecords.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-EnableLoginByWam

[Versão prévia] Quando habilitado, o WAM (Gerenciador de Contas Web) será a experiência de logon interativa padrão. Ele retornará ao uso do navegador se a plataforma não oferecer suporte ao WAM. Observe que esse recurso está em versão prévia. No momento, não há suporte para MSA (Conta da Microsoft). Fique à vontade para entrar em contato com a equipe do Azure PowerShell se você tiver comentários: 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

-Force

Não peça confirmação ao limpar todas as configurações.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-LoginExperienceV2

Somente ativo ao autenticar interativamente, permite que o usuário escolha a assinatura e o locatário usados nos comandos subsequentes. Os valores possíveis são "Ativado" (Padrão) e "Desativados". 'Ativado' requer a entrada do usuário. 'Off' usará o primeiro locatário e a assinatura retornada pelo Azure, poderá ser alterado sem aviso prévio e levar à execução de comando em um contexto indesejado (não recomendado).

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-PassThru

Retornará true se o cmdlet for executado corretamente.

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

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:	SwitchParameter
Aliases:	wi
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Entradas

None

Saídas

Boolean