Condividi tramite

Remove-Variable

Modulo:
Microsoft.PowerShell.Utility Module

Elimina una variabile e il relativo valore.

Sintassi

Default (impostazione predefinita). 

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

Descrizione

Il cmdlet Remove-Variable elimina una variabile e il relativo valore dall'ambito in cui è definito, ad esempio la sessione corrente. Non è possibile usare questo cmdlet per eliminare le variabili impostate come costanti o quelle di proprietà del sistema.

Esempio

Esempio 1: Rimuovere una variabile

Remove-Variable Smp

Questo comando elimina la variabile $Smp.

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 dall'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

Indica che il cmdlet rimuove una variabile anche se è di sola lettura. Anche se si usa il parametro force, il cmdlet non può rimuovere una costante.

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 eliminati da questo 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 rimuovere. Il nome del parametro (Nome) è facoltativo. Sono consentiti caratteri jolly

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

-Scope

Ottiene solo le variabili nell'ambito specificato. I valori accettabili per questo parametro sono:

  • Generale
  • Locale
  • Sceneggiatura
  • Numero riferito all'ambito attuale (da 0 al numero di ambiti, dove 0 è l'ambito attuale e 1 è l'ambito 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

PSVariable

È possibile inviare tramite pipe un oggetto variabile a questo cmdlet.

Output

None

Questo cmdlet non restituisce alcun output.

Note

PowerShell include gli alias seguenti per Remove-Variable:

  • Tutte le piattaforme:

    • rv

  • Le modifiche influiscono solo sull'ambito corrente, ad esempio una sessione. Per eliminare una variabile da tutte le sessioni, aggiungere un comando Remove-Variable al profilo di PowerShell.