Clear-Variable (Microsoft.PowerShell.Utility)

Clear-Variable

Modül:
Microsoft.PowerShell.Utility

Bir değişkenin değerini siler.

Sözdizimi

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

Tanım

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

Örnekler

Örnek 1: Bir arama dizesiyle başlayan genel değişkenlerin değerini kaldırın

Clear-Variable my* -Scope Global

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

Örnek 2: Alt kapsamdaki bir değişkeni temizleyin ancak üst kapsamı temizlemeyin

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

3

Bu komutlar, alt kapsamdaki bir değişkenin temizlenmesinin üst kapsamdaki değeri temizlemediğini gösterir. İlk komut, $a değişkeninin değerini 3'e ayarlar. İkinci komut, Clear-Variable&) kullanır. > yeni bir kapsamda komut. Değişken alt kapsamda temizlenir (her ne kadar mevcut olmasa da), ancak yerel kapsamda temizlenmez. $a değerini alan üçüncü komut, 3 değerinin etkilenmediğini gösterir.

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

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 mevcuttur ancak değer null'dur.

Parametreler

-Confirm

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

Tip :

SwitchParameter

Takma adlar:

cf

Konum:

Adlandırılmış

Varsayılan değer:

False

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Exclude

Bu cmdlet'in işlemde atladığı öğelerin dizisini belirtir. Bu parametrenin değeri Ad parametresini nitelendirir. "s*" gibi bir ad öğesi veya desen girin. Joker karakterlere izin verilir.

Tip :

String[]

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

True

-Force

Cmdlet'in bir değişkeni salt okunur olsa bile temizlemesine izin verir. Force parametresi kullanıldığında bile cmdlet sabitleri temizleyemez.

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Include

Bu cmdlet'in işlemde içerdiği öğelerin dizisini belirtir. Bu parametrenin değeri Ad parametresini nitelendirir. "s*" gibi bir ad öğesi veya desen girin. Joker karakterlere izin verilir.

Tip :

String[]

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

True

-Name

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

Tip :

String[]

Konum:

0

Varsayılan değer:

None

Gerekli:

True

Boru hattı girişini kabul edin:

True

Joker karakterleri kabul et:

True

-PassThru

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

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Scope

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

Bu parametre için kabul edilebilir değerler şunlardır:

    Global
    Local
    Script

Geçerli kapsama göreli bir sayı da kullanabilirsiniz (0'dan kapsam sayısına kadar; burada 0 geçerli kapsam ve 1 onun üst öğesidir). Yerel varsayılandır. Daha fazla bilgi için bkz. about_Scopes.

Tip :

String

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-WhatIf

Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmıyor.

Tip :

SwitchParameter

Takma adlar:

wi

Konum:

Adlandırılmış

Varsayılan değer:

False

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

Girişler

Yok

Nesneleri bu cmdlet'e aktaramazsınız.

Çıkışlar

Yok

Varsayılan olarak bu cmdlet hiçbir çıktı döndürmez.

PSDeğişkeni

PassThru parametresini kullandığınızda bu cmdlet, temizlenen değişkeni temsil eden bir PSVariable nesnesi döndürür.

Notlar

PowerShell, Clear-Variable için aşağıdaki takma adları içerir:

  • Tüm platformlar:

      clv

  • Bir değişkeni değeriyle birlikte silmek için Remove-Variable veya Remove-Item komutunu kullanın.

    Bu cmdlet, Force parametresini kullansanız bile sabit olarak ayarlanan veya sistemin sahip olduğu değişkenlerin değerlerini silmez.

    Temizlediğiniz değişken mevcut değilse cmdlet'in hiçbir etkisi olmaz. Boş değere sahip bir değişken oluşturmaz.

İlgili makaleler