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 di 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 che hanno nomi che iniziano con my.

Esempio 2: Cancellare una variabile in un ambito figlio, ma non nell'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 Processi. Al termine dell'operazione, la variabile denominata Processi esiste ancora, ma il valore è Null.

Parametri

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Name

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

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 (0 tramite il numero di ambiti, dove 0 è l'ambito corrente e 1 è il relativo padre). Local è il valore predefinito. Per altre informazioni, vedere about_Scopes.

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

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

Input

None

Non è possibile eseguire la pipe degli 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 avrà alcun effetto. Non crea una variabile con un valore null.