Aracılığıyla paylaş

Clear-Variable

  • Başvuru
Modül:
Microsoft.PowerShell.Utility

Değişkenin değerini siler.

Syntax

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

Description

cmdlet'i Clear-Variable bir değişkende depolanan verileri siler, ancak değişkeni silmez. Sonuç olarak değişkeninin değeri NULL (boş) olur. Değişkende belirtilen veri veya nesne türü varsa, bu cmdlet değişkende depolanan nesnenin türünü korur.

Örnekler

Örnek 1: Arama dizesiyle başlayan genel değişkenlerin değerini kaldırma

Clear-Variable my* -Scope Global

Bu komut, ile başlayan adlara sahip genel değişkenlerin değerini kaldırır.

Örnek 2: Üst kapsamda değil alt kapsamdaki bir değişkeni temizleme

$a=3
&{ Clear-Variable a }
$a

3

Bu komutlar, alt kapsamdaki bir değişkeni temizlemenin üst kapsamdaki değeri temizlemediğini gösterir. İlk komut değişkeninin $a değerini 3 olarak ayarlar. İkinci komut, komutu yeni bir kapsamda çalıştırmak için invoke işlecini Clear-Variable (& ) kullanır. Değişken alt kapsamda (mevcut olmamasına rağmen) temizlenir, ancak yerel kapsamda temizlenmez. değerini $aalan üçüncü komut, 3 değerinin etkilenmediğini gösterir.

Örnek 3: Belirtilen değişkenin değerini silme

Clear-Variable -Name "Processes"

Bu komut İşlemler adlı değişkenin değerini siler. Cmdlet işlemi tamamladıktan sonra İşlemler adlı değişken hala var olur, ancak değer null olur.

Parametreler

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

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

-Exclude

Bu cmdlet'in işlemde atlayan öğe dizisini belirtir. Bu parametrenin değeri Name parametresini niteler. "s*" gibi bir ad öğesi veya desen girin. Joker karakterlere izin verilir.

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

-Force

Cmdlet'in salt okunur olsa bile değişkeni temizlemesine izin verir. Force parametresini kullanarak bile cmdlet sabitleri temizleyemez.

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

-Include

Bu cmdlet'in işleme dahil olduğu bir öğe dizisini belirtir. Bu parametrenin değeri Name parametresini niteler. "s*" gibi bir ad öğesi veya desen girin. Joker karakterlere izin verilir.

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

-Name

Temizlenecek değişkenin adını belirtir. Joker karakterlere izin verilir. Bu parametre gereklidir, ancak ad parametresi isteğe bağlıdır.

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

-PassThru

Üzerinde çalıştığınız öğeyi temsil eden bir nesne döndürür. Varsayılan olarak bu cmdlet herhangi bir çıktı üretmez.

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

-Scope

Bu diğer adın geçerli olduğu kapsamı belirtir.

Bu parametrenin kabul edilebilir değerleri şunlardır:

  • Global
  • Local
  • Script

Geçerli kapsama göre bir sayı da kullanabilirsiniz (0, geçerli kapsam ve 1'in üst kapsam olduğu kapsam sayısı aracılığıyla). Yerel varsayılan değerdir. Daha fazla bilgi için bkz. about_Scopes.

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

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

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

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

None or System.Management.Automation.PSVariable

PassThru parametresini kullandığınızda, bu cmdlet temizlenen değişkeni temsil eden bir System.Management.Automation.PSVariable nesnesi oluşturur. Aksi takdirde, bu cmdlet herhangi bir çıkış oluşturmaz.

Notlar

  • Bir değişkeni değeriyle birlikte silmek için veya Remove-ItemkullanınRemove-Variable.

    Bu cmdlet, Force parametresini kullansanız bile sabit olarak ayarlanan veya sisteme ait olan değişkenlerin değerlerini silmez.

    Temizlediğiniz değişken yoksa, cmdlet'in hiçbir etkisi yoktur. Null değere sahip bir değişken oluşturmaz.

    Yerleşik diğer adı clvolan öğesine de başvurabilirsinizClear-Variable. Daha fazla bilgi için bkz. about_Aliases.