Clear-Variable
Değişkenin değerini siler.
Sözdizimi
Default EnterprisePublishing
Clear-Variable
[-Name] <String[]>
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-PassThru]
[-Scope <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
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: 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: Alt kapsamda bir değişkeni temizleme, ancak üst kapsamda değil
$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 $a değişkeninin değerini 3 olarak ayarlar. İkinci komut, & komutunu yeni bir kapsamda çalıştırmak için invoke işlecini (Clear-Variable) kullanır. Değişken, var olmasa bile alt düzey kapsamda temizlenir, ancak yerel kapsamda temizlenmez.
$adeğerini alan üçü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.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Cf |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Exclude
Bu cmdlet'in işlemde hariç tuttuğu öğe dizisini belirtir. Bu parametrenin değeri, Adı parametresini niteler. "s*" gibi bir ad öğesi veya desen girin. Joker karakterlere izin verilir.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Force
Cmdlet'in salt okunur olsa bile değişkeni temizlemesine izin verir. Force parametresi kullanıldığında bile, cmdlet sabitleri temizleyemez.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Include
Bu cmdlet'in işleme dahil olduğu bir öğe dizisini belirtir. Bu parametrenin değeri, Adı parametresini niteler. "s*" gibi bir ad öğesi veya desen girin. Joker karakterlere izin verilir.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Name
Temizlenecek değişkenin adını belirtir. Joker karakterlere izin verilir. Bu parametre gereklidir, ancak parametre adı Adı isteğe bağlıdır.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | 0 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-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.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Scope
Bu diğer adın geçerli olduğu kapsamı belirtir.
Bu parametre için kabul edilebilir değerler şunlardır:
GlobalLocalScript
Ayrıca, mevcut kapsamla ilişkili olarak bir sayı da kullanabilirsiniz (0, 0 mevcut kapsamdır ve 1 onun ebeveyn kapsamıdır). Yerel varsayılandır. Daha fazla bilgi için bkz. about_Scopes.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-WhatIf
Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmaz.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Wi |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
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, Clear-Variableiçin aşağıdaki diğer adları içerir:
Tüm platformlar:
clv
Bir değişkeni değeriyle birlikte silmek için
Remove-VariableveyaRemove-Itemkullanın.Bu cmdlet, Force parametresini kullansanız bile sabit olarak ayarlanan veya sistem tarafından sahip olunan 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.
