Remove-Variable

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Elimina una variabile e il relativo valore.

Sintassi

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

Descrizione

Il Remove-Variable cmdlet 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à dal sistema.

Esempio

Esempio 1: Rimuovere una variabile

Remove-Variable Smp

Questo comando elimina la $Smp variabile.

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

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.

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 eliminati da questo cmdlet nell'operazione. Il valore di questo parametro qualifica il parametro Name . Immettere un elemento o un criterio 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 rimuovere. Il nome del parametro (Nome) è facoltativo. Sono consentiti caratteri jolly

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

-Scope

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

  • Generale
  • Locale
  • Script
  • 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

PSVariable

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

Output

None

Questo cmdlet non restituisce output.

Note

PowerShell include gli alias seguenti per Remove-Variable:

  • Tutte le piattaforme:

    • rv

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