Condividi tramite

Clear-Variable

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Elimina il valore di una variabile.

Sintassi

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

Descrizione

Il Clear-Variable cmdlet elimina i dati archiviati in una variabile, ma non elimina la variabile. Di conseguenza, il valore della variabile sarà 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 dimostrano 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 Clear-Variable comando in un nuovo ambito. La variabile viene cancellata nell'ambito figlio (sebbene non esisteva), 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.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Exclude

Specifica una matrice di elementi che questo cmdlet omette nell'operazione. Il valore di questo parametro qualifica il parametro Name . Immettere un elemento o modello di nome, ad esempio "s*". I caratteri jolly sono consentiti.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-Force

Consente al cmdlet di cancellare una variabile, anche se è di sola lettura. Il cmdlet non può cancellare le costanti, neanche usando il parametro Force.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Include

Specifica una matrice di elementi inclusi nel cmdlet nell'operazione. Il valore di questo parametro qualifica il parametro Name . Immettere un elemento o modello di nome, ad esempio "s*". I caratteri jolly sono consentiti.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

-Name

Specifica il nome della variabile da cancellare. I caratteri jolly sono consentiti. Questo parametro è obbligatorio, ma il nome del parametro Name è facoltativo.

Tipo:String[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:True

-PassThru

Restituisce un oggetto che rappresenta l'elemento in uso. Per impostazione predefinita, il cmdlet non genera alcun output.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Scope

Specifica l'ambito in cui questo alias è valido.

I valori validi 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.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Non è possibile inviare tramite pipe oggetti 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

Windows PowerShell include gli alias seguenti per Clear-Variable:

  • 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 avrà alcun effetto. Non crea una variabile con un valore null.