Remove-Variable (Microsoft.PowerShell.Utility)

Remove-Variable

Modul:

Microsoft.PowerShell.Utility

Töröl egy változót és annak értékét.

Szintaxis

Remove-Variable
      [-Name] <String[]>
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-Force]
      [-Scope <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Leírás

A Remove-Variable parancsmag törli a változót és annak értékét abból a hatókörből, amelyben meghatározásra került, például az aktuális munkamenetből. Ezzel a parancsmaggal nem törölheti az állandóként beállított vagy a rendszer tulajdonában lévő változókat.

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.

Típus:

SwitchParameter

Álnevek:

cf

Pozíció:

Elnevezett

Alapértelmezett érték:

False

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-Exclude

Olyan elemek tömbjét adja meg, amelyeket ez a parancsmag kihagy a műveletből. Ennek a paraméternek az értéke minősíti a Name paramétert. Adjon meg egy névelemet vagy mintát, például „s*”. Helyettesítő karakterek megengedettek.

Típus:

String[]

Pozíció:

Elnevezett

Alapértelmezett érték:

None

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

True

-Force

Azt jelzi, hogy a parancsmag akkor is eltávolít egy változót, ha az írásvédett. A parancsmag még a Force paraméter használatával sem tud eltávolítani egy állandót.

Típus:

SwitchParameter

Pozíció:

Elnevezett

Alapértelmezett érték:

None

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-Include

Azon elemek tömbjét adja meg, amelyeket ez a parancsmag a művelet során töröl. Ennek a paraméternek az értéke minősíti a Name paramétert. Adjon meg egy névelemet vagy mintát, például s*. Helyettesítő karakterek megengedettek.

Típus:

String[]

Pozíció:

Elnevezett

Alapértelmezett érték:

None

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

True

-Name

Megadja az eltávolítandó változó nevét. A paraméter neve (Name) nem kötelező. Helyettesítő karakterek megengedettek

Típus:

String[]

Pozíció:

0

Alapértelmezett érték:

None

Kívánt:

True

Csővezeték bevitel elfogadása:

True

Helyettesítő karakterek elfogadása:

True

-Scope

Csak a megadott hatókör változóit kéri le. Ennek a paraméternek az elfogadható értékei:

• Globális
• Helyi
• Forgatókönyv
• Az aktuális hatókörhöz viszonyított szám (0-tól a hatókörök számáig, ahol 0 az aktuális hatókör és 1 a szülője)

A helyi az alapértelmezett. További információ: about_Scopes.

Típus:

String

Pozíció:

Elnevezett

Alapértelmezett érték:

None

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-WhatIf

Megmutatja, mi történik, ha a parancsmag lefut. A parancsmag nem fut.

Típus:

SwitchParameter

Álnevek:

wi

Pozíció:

Elnevezett

Alapértelmezett érték:

False

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

Bemenetek

PSVariable

Ebbe a parancsmagba egy változó objektumot is átvezethet.

Kimenetek

Nincs

Ez a parancsmag nem ad vissza kimenetet.

Megjegyzések

A PowerShell a következő álneveket tartalmazza a Remove-Variable számára:

• Minden platform:

  rv

• A változtatások csak az aktuális hatókört érintik, például egy munkamenetet. Ha törölni szeretne egy változót az összes munkamenetből, adjon hozzá egy Remove-Variable parancsot PowerShell-profiljához.