Clear-Variable
Egy változó értékét törli.
Syntax
Default (Alapértelmezett)
Clear-Variable
[-Name] <String[]>
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-PassThru]
[-Scope <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
A Clear-Variable parancsmag törli a változóban tárolt adatokat, de nem törli a változót. Ennek eredményeként a változó értéke NULL (üres). Ha a változó megadott adat- vagy objektumtípussal rendelkezik, ez a parancsmag megőrzi a változóban tárolt objektum típusát.
Példák
1. példa: Keresési sztringgel kezdődő globális változók értékének eltávolítása
Clear-Variable my* -Scope Global
Ez a parancs eltávolítja azoknak a globális változóknak az értékét, amelyek a saját névvel kezdődnek.
2. példa: Változó törlése egy gyermekhatókörben, a szülőhatókörben nem
$a = 3
&{ Clear-Variable a }
$a
3
Ezek a parancsok azt mutatják, hogy a változók gyermekhatókörben való törlése nem törli a szülőhatókör értékét. Az első parancs a $a változó értékét 3-ra állítja. A második parancs a meghívási operátor (&) használatával futtatja a Clear-Variable parancsot egy új hatókörben. A változó törlődik a gyermek hatókörben (bár nem létezik), de a helyi hatókörben nincs törölve.
A harmadik parancs, amely a $aértékét kapja, azt mutatja, hogy a 3 érték nincs hatással.
3. példa: A megadott változó értékének törlése
Clear-Variable -Name "Processes"
Ez a parancs törli a Folyamatok nevű változó értékét. Miután a parancsmag befejezte a műveletet, a Folyamatok nevű változó továbbra is létezik, de az érték null.
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
Lehetővé teszi, hogy a parancsmag töröljön egy változót, még akkor is, ha írásvédett. A Parancsmag még a Force paraméter használatával sem tudja törölni az állandókat.
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 szereplő 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
Megadja a törölni kívánt változó nevét. Helyettesítő karakterek használata engedélyezett. Ez a paraméter kötelező, de a paraméter neve Név megadása nem kötelező.
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 |
-PassThru
Azt az elemet képviselő objektumot adja vissza, amellyel dolgozik. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.
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 |
-Scope
Azt a hatókört adja meg, amelyben az alias érvényes.
A paraméter elfogadható értékei a következők:
GlobalLocalScript
Az aktuális hatókörhöz viszonyított számot is használhat (0 a hatókörök számán keresztül, ahol a 0 az aktuális hatókör, az 1 pedig a szülője). 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
None
Ehhez a parancsmaghoz nem lehet objektumokat csövezni.
Kimenetek
None
Ez a parancsmag alapértelmezés szerint nem ad vissza kimenetet.
PSVariable
A PassThru paraméter használatakor ez a parancsmag egy PSVariable objektumot ad vissza, amely a törölt változót jelöli.
Jegyzetek
A PowerShell a következő aliasokat tartalmazza Clear-Variable:
Minden platform:
clv
Ha törölni szeretne egy változót az értékével együtt, használja
Remove-VariablevagyRemove-Item.Ez a parancsmag nem törli az állandóként vagy a rendszer tulajdonában lévő változók értékeit, még akkor sem, ha a Force paramétert használja.
Ha a törölni kívánt változó nem létezik, a parancsmagnak nincs hatása. Nem hoz létre null értékű változót.
