Condividi tramite

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 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à dal sistema.

Esempio

Esempio 1: Rimuovere una variabile

PS C:\> Remove-Variable Smp

Questo comando elimina la variabile $Smp.

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

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

-Force

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

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

-Include

Specifica una matrice di elementi eliminati dal cmdlet nell'operazione. Il valore di questo parametro qualifica il parametro Name . Immettere un elemento o un modello 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:False

-Name

Specifica il nome della variabile da rimuovere. Il nome del parametro (Nome) è facoltativo.

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

-Scope

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

  • Globale
  • Locale
  • Script
  • Numero relativo all'ambito corrente (0 al 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

PSVariable

È possibile eseguire la pipe di un oggetto variabile in Remove-Variable.

Output

None

Questo cmdlet non restituisce alcun output.

Note

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

    È anche possibile fare riferimento a Remove-Variable tramite il relativo alias predefinito, rv. Per altre informazioni, vedere about_Aliases.