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

Clear-Variable Cmdlet 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: 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şkenin $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 temizlenir (mevcut olmasa da), 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 parametresi kullanıldığında 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 çıkış oluşturmaz.

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

Ayrıca, geçerli kapsama göre bir sayı da kullanabilirsiniz (0, 0 geçerli kapsam, 1 ise onun üst kapsamıdır). Yerel varsayılandır. 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

Varsayılan olarak, bu cmdlet çıkış döndürmez.

PSVariable

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

Notlar

PowerShell için aşağıdaki diğer adları Clear-Variableiçerir:

  • Tüm platformlar:

    • clv

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