Clear-AzConfig

Cancella i valori delle configurazioni impostate dall'utente.

Sintassi

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]
     [-DisableErrorRecordsPersistence]
     [-DisableInstanceDiscovery]
     [-DisplayBreakingChangeWarning]
     [-DisplayRegionIdentified]
     [-DisplaySurveyMessage]
     [-EnableDataCollection]
     [-EnableLoginByWam]
     [<CommonParameters>]

Descrizione

Cancella i valori delle configurazioni impostate dall'utente. Per impostazione predefinita, tutte le configurazioni verranno cancellate. È anche possibile specificare le chiavi delle configurazioni da cancellare.

Esempio

Esempio 1

Clear-AzConfig -Force

Cancellare tutte le configurazioni. -Force elimina la richiesta di conferma.

Esempio 2

Clear-AzConfig -EnableDataCollection

Cancellare la configurazione "EnableDataCollection".

Parametri

-AppliesTo

Specifica a quale parte di Azure PowerShell si applica la configurazione. I valori possibili sono:

  • "Az": la configurazione si applica a tutti i moduli e i cmdlet di Azure PowerShell.
  • Nome modulo: la configurazione si applica a un determinato modulo di Azure PowerShell. Ad esempio, "Az.Archiviazione".
  • Nome del cmdlet: la configurazione si applica a un determinato cmdlet di Azure PowerShell. Ad esempio, "Get-AzKeyVault". Se non specificato, quando si ottengono o cancellano le configurazioni, per impostazione predefinita viene impostato su tutti i valori precedenti; durante l'aggiornamento, per impostazione predefinita è "Az".
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CheckForUpgrade

Se abilitata, Azure PowerShell verificherà automaticamente la disponibilità degli aggiornamenti e visualizzerà un messaggio di suggerimento quando è disponibile un aggiornamento. Il valore predefinito è true.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultSubscriptionForLogin

Nome della sottoscrizione o GUID. Imposta il contesto predefinito per Azure PowerShell durante l'accesso senza specificare una sottoscrizione.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableErrorRecordsPersistence

Se disabilitato, i record di errore non verranno scritti in ~/. Azure/ErrorRecords. Questa configurazione verrà sostituita da "EnableErrorRecordsPersistence" come consenso esplicito nella prossima versione principale di Az intorno a novembre 2023.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableInstanceDiscovery

Impostare su true per disabilitare sia l'individuazione dell'istanza che la convalida dell'autorità. Questa funzionalità è destinata all'uso in scenari in cui non è possibile raggiungere l'endpoint dei metadati, ad esempio nei cloud privati o in Azure Stack. Il processo di individuazione dell'istanza comporta il recupero dei metadati dell'autorità da https://login.microsoft.com/ per convalidare l'autorità. Impostando questa proprietà su true, la convalida dell'autorità è disabilitata. Di conseguenza, è fondamentale assicurarsi che l'host dell'autorità configurata sia valido e attendibile.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayBreakingChangeWarning

Controlla se i messaggi di avviso per le modifiche di rilievo vengono visualizzati o eliminati. Se abilitata, viene visualizzato un avviso di modifica di rilievo durante l'esecuzione di cmdlet con modifiche di rilievo in una versione futura.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayRegionIdentified

Se abilitata, Azure PowerShell visualizza raccomandazioni sulle aree che possono ridurre i costi.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplaySecretsWarning

Se abilitata, viene visualizzato un messaggio di avviso quando l'output del cmdlet contiene segreti. Per altre informazioni: https://go.microsoft.com/fwlink/?linkid=2258844

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplaySurveyMessage

Se abilitata, viene richiesto raramente di partecipare ai sondaggi dell'esperienza utente per Azure PowerShell.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableDataCollection

Se abilitata, i cmdlet di Azure PowerShell inviano dati di telemetria a Microsoft per migliorare l'esperienza del cliente. Per altre informazioni, vedere l'informativa sulla privacy: https://aka.ms/privacy

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableLoginByWam

[Anteprima] Se abilitata, Gestione account Web (WAM) sarà l'esperienza di accesso interattiva predefinita. Verrà eseguito il fallback all'uso del browser se la piattaforma non supporta WAM. Si noti che questa funzionalità è in anteprima. L'account Microsoft (MSA) non è attualmente supportato. È possibile contattare il team di Azure PowerShell se si hanno commenti e suggerimenti: https://aka.ms/azpsissue

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Non chiedere conferma quando si cancellano tutte le configurazioni.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Restituisce true se il cmdlet viene eseguito correttamente.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Scope

Determina l'ambito delle modifiche alla configurazione, ad esempio se le modifiche si applicano solo al processo corrente o a tutte le sessioni avviate dall'utente. Per impostazione predefinita, è CurrentUser.

Type:ConfigScope
Accepted values:CurrentUser, Process, Default, Environment
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

None

Output

Boolean