Remove-Variable
Töröl egy változót és annak értékét.
Syntax
Default (Alapértelmezett)
Remove-Variable
[-Name] <String[]>
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Scope <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
A Remove-Variable parancsmag töröl egy változót és annak értékét a definiálás hatóköréből, például az aktuális munkamenetből. Ez a parancsmag nem használható állandóként vagy a rendszer tulajdonában lévő változók törlésére.
Példák
1. példa: Változó eltávolítása
Remove-Variable Smp
Ez a parancs törli a $Smp változót.
Paraméterek
-Confirm
Megerősítést kér a parancsmag futtatása előtt.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Cf |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Exclude
Olyan elemek tömbje, amelyeket ez a parancsmag kihagy a műveletből. A paraméter értéke megfelel a Név paraméternek. Adjon meg egy névelemet vagy mintát, például "s*". Helyettesítő karakterek használata engedélyezett.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Force
Azt jelzi, hogy a parancsmag akkor is eltávolít egy változót, ha írásvédett. Még a Force paramétert is használva a parancsmag nem tud eltávolítani egy állandót.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Include
A parancsmag által a műveletben törölt elemek tömbjének megadása. A paraméter értéke megfelel a Név paraméternek. Adjon meg egy névelemet vagy mintát, például s*. Helyettesítő karakterek használata engedélyezett.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Name
Az eltávolítandó változó nevét adja meg. A paraméter neve (Név) megadása nem kötelező. Helyettesítő karakterek használata engedélyezett
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | True |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | False |
-Scope
Csak a megadott hatókörben lévő változókat kapja meg. A paraméter elfogadható értékei a következők:
- Globális
- Helyi
- Szkript
- Az aktuális hatókörhöz viszonyított szám (0-tól a hatókörök számáig terjedően, ahol a 0 az aktuális hatókört, az 1 pedig a szülőt jelenti)
A helyi az alapértelmezett. További információ található a about_Scopesrészben.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-WhatIf
Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | False |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Wi |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
PSVariable
A parancsmaghoz egy változó objektumot is be lehet csövezni.
Kimenetek
None
Ez a parancsmag nem ad vissza kimenetet.
Jegyzetek
A PowerShell a következő aliasokat tartalmazza Remove-Variable:
Minden platform:
rv
A módosítások csak az aktuális hatókört érintik, például egy munkamenetet. Ha minden munkamenetből törölni szeretne egy változót, adjon hozzá egy
Remove-Variableparancsot a PowerShell-profiljához.
