Condividi tramite

Clear-Variable

Modulo:
Microsoft.PowerShell.Utility Module

Elimina il valore di una variabile.

Sintassi

Default (impostazione predefinita). 

Clear-Variable
    [-Name] <String[]>
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Force]
    [-PassThru]
    [-Scope <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Descrizione

Il cmdlet Clear-Variable elimina i dati archiviati in una variabile, ma non elimina la variabile. Di conseguenza, il valore della variabile è NULL (vuoto). Se la variabile ha un tipo di dati o oggetto specificato, questo cmdlet mantiene il tipo dell'oggetto archiviato nella variabile.

Esempio

Esempio 1: Rimuovere il valore delle variabili globali che iniziano con una stringa di ricerca

Clear-Variable my* -Scope Global

Questo comando rimuove il valore delle variabili globali con nomi che iniziano con my.

Esempio 2: Cancellare una variabile in un ambito figlio ma non l'ambito padre

$a = 3
&{ Clear-Variable a }
$a

3

Questi comandi mostrano che la cancellazione di una variabile in un ambito figlio non cancella il valore nell'ambito padre. Il primo comando imposta il valore della variabile $a su 3. Il secondo comando usa l'operatore invoke (&) per eseguire il comando Clear-Variable in un nuovo ambito. La variabile viene cancellata nell'ambito figlio (anche se non esiste), ma non viene cancellata nell'ambito locale. Il terzo comando, che ottiene il valore di $a, indica che il valore 3 non è interessato.

Esempio 3: Eliminare il valore della variabile specificata

Clear-Variable -Name "Processes"

Questo comando elimina il valore della variabile denominata Processes. Al termine dell'operazione, la variabile denominata Processes esiste ancora, ma il valore è Null.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Exclude

Specifica una matrice di elementi che questo cmdlet omette nell'operazione. Il valore di questo parametro specifica il parametro Nome. Immettere un elemento o un criterio nome, ad esempio "s*". Sono consentiti i metacaratteri.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:True
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Force

Consente al cmdlet di cancellare una variabile anche se è di sola lettura. Anche se si usa il parametro Force, il cmdlet non può cancellare le costanti.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Include

Specifica una matrice di elementi inclusi nel cmdlet nell'operazione. Il valore di questo parametro specifica il parametro Nome. Immettere un elemento o un criterio nome, ad esempio "s*". Sono consentiti i metacaratteri.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:True
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Name

Specifica il nome della variabile da cancellare. Sono consentiti i metacaratteri. Questo parametro è obbligatorio, ma il nome del parametro Nome è facoltativo.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:True
DontShow:False

Set di parametri

(All)
Posizione:0
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-PassThru

Restituisce un oggetto che rappresenta l'elemento con cui si sta lavorando. Per impostazione predefinita, questo cmdlet non genera alcun output.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Scope

Specifica l'ambito in cui questo alias è valido.

I valori accettabili per questo parametro sono:

  • Global
  • Local
  • Script

È anche possibile usare un numero relativo all'ambito corrente (da 0 al numero di ambiti, dove 0 è l'ambito corrente e 1 è il relativo elemento padre). Local è l'impostazione predefinita. Per altre informazioni, vedere about_Scopes.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

None

Gli oggetti non possono essere inviati tramite pipe a questo cmdlet.

Output

None

Per impostazione predefinita, questo cmdlet non restituisce alcun output.

PSVariable

Quando si usa il parametro PassThru, questo cmdlet restituisce un oggetto PSVariable che rappresenta la variabile cancellata.

Note

PowerShell include gli alias seguenti per Clear-Variable:

  • Tutte le piattaforme:

    • clv

  • Per eliminare una variabile, insieme al relativo valore, usare Remove-Variable o Remove-Item.

    Questo cmdlet non elimina i valori delle variabili impostate come costanti o di proprietà del sistema, anche se si usa il parametro Force .

    Se la variabile che si sta cancellando non esiste, il cmdlet non ha alcun effetto. Non crea una variabile con un valore Null.