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 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.

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 nome. Immettere un elemento o un criterio nome, ad esempio "s*". Sono consentiti caratteri jolly.

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. Anche se si usa il parametro Force, il cmdlet non può cancellare le costanti.

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 nome. Immettere un elemento o un criterio nome, ad esempio "s*". Sono consentiti caratteri jolly.

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. Sono consentiti caratteri jolly. Questo parametro è obbligatorio, ma il nome del parametro Nome è 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 con cui si sta lavorando. Per impostazione predefinita, questo 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 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.

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

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. 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

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.