Remove-Variable
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 è definita, 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
PS C:\> 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: | 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 |
-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: | 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 |
-Name
Specifica il nome della variabile da rimuovere. Il nome del parametro (Nome) è facoltativo.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| 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 ulteriori 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 reindirizzare un oggetto variabile a Remove-Variable.
Output
None
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 un comando Remove-Variable al profilo di Windows PowerShell.
È inoltre possibile fare riferimento a Remove-Variable tramite il suo alias incorporato, rv. Per altre informazioni, vedere about_Aliases.