Clear-Variable

  • Referencia
Modul:
Microsoft.PowerShell.Utility

Egy változó értékét törli.

Syntax

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 változó $a értékét 3 értékre á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 az értéket $akapja, 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

Jóváhagyást kér a parancsmag futtatása előtt.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Exclude

Olyan elemek tömbje, amelyeket ez a parancsmag kihagy a műveletből. Ennek a paraméternek az értéke a Név paramétert minősíti. Adjon meg egy névelemet vagy mintát, például "s*". Helyettesítő karakterek használata engedélyezett.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Include

A parancsmag által a műveletben szereplő elemek tömbjének megadása. Ennek a paraméternek az értéke a Név paramétert minősíti. Adjon meg egy névelemet vagy mintát, például "s*". Helyettesítő karakterek használata engedélyezett.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-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 nem kötelező.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-PassThru

Azt az elemet képviselő objektumot adja vissza, amellyel dolgozik. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Scope

Azt a hatókört adja meg, amelyben az alias érvényes.

A paraméter elfogadható értékei a következők:

  • Global
  • Local
  • Script

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). Az alapértelmezett érték a helyi. További információ: about_Scopes.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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 Clear-Variabletartalmazza:

  • Összes platform:

    • clv

  • Ha törölni szeretne egy változót az értékével együtt, használja Remove-Variable vagy Remove-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.