Remove-Variable
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 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: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 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: | True |
-Name
Specifica il nome della variabile da rimuovere. Il nome del parametro (Nome) è facoltativo. I caratteri jolly sono consentiti
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Scope
Ottiene solo le variabili nell'ambito specificato. I valori validi per questo parametro sono:
- Globale
- 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.
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
È 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.