Remove-Variable

Articolo
10/30/2009

Elimina una variabile e il relativo valore.

Sintassi

Remove-Variable [-Name] <string[]> [-Exclude <string[]>] [-Force] [-Include <string[]>] [-Scope <string>] [-Confirm] [-WhatIf] [<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 utilizzare questo cmdlet per eliminare variabili impostate come costanti o di proprietà del sistema.

Parametri

-Exclude <string[]>

Omette gli elementi specificati. Il valore di questo parametro qualifica il parametro Name. Immettere un criterio o un elemento del nome, ad esempio "s*". È consentito l'utilizzo di caratteri jolly.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Force

Consente al cmdlet di rimuovere una variabile anche se è di sola lettura. Anche se si utilizza il parametro Force, il cmdlet non può rimuovere una costante.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Include <string[]>

Elimina unicamente gli elementi specificati. Il valore di questo parametro qualifica il parametro Name. Immettere un criterio o un elemento del nome, ad esempio "s*". È consentito l'utilizzo di caratteri jolly.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Name <string[]>

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

Obbligatorio?	true
Posizione?	1
Valore predefinito
Accettare input da pipeline?	true (ByPropertyName)
Accettare caratteri jolly?	false

-Scope <string>

Specifica l'ambito in cui l'alias è considerato valido. I valori validi sono "Global", "Local", "Script" oppure un numero relativo all'ambito corrente, ovvero da 0 al numero di ambiti, dove 0 corrisponde all'ambito corrente e 1 al relativo padre. Il valore predefinito è "Local". Per ulteriori informazioni, vedere about_Scopes.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Confirm

Chiede una conferma prima di eseguire il comando.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-WhatIf

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

<CommonParameters>

Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.

Input e output

Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.

Input

System.Management.Automation.PSVariable

È possibile reindirizzare un oggetto variabile a Remove-Variable.

Output

Nessuno

Questo cmdlet non restituisce alcun output.

Note

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

È inoltre possibile fare riferimento a RemoveVariable tramite il relativo alias predefinito "rv". Per ulteriori informazioni, vedere about_Aliases.

Esempio 1

C:\PS>remove-variable Smp

Descrizione
-----------
Questo comando elimina la variabile $Smp.

Vedere anche

Concetti

Set-Variable
Get-Variable
Clear-Variable
New-Variable
about_Profiles

Condividi tramite