Clear-Variable
Değişkenin değerini siler.
Syntax
Default (Varsayılan)
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
PS C:\> 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
PS C:\> $a=3
PS C:\> &{ Clear-Variable a }
PS C:\> $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, Clear-Variable komutunu yeni bir kapsamda çalıştırmak için invoke işlecini (&) kullanır. Değişken, var olmasa bile alt düzey kapsamda temizlenir, 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 silme
PS C:\> 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:
- Global
- Yerel
- Senaryo
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 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
Değişkeni ve değerini silmek için Remove-Variable veya Remove-Item kullanı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.
Ayrıca yerleşik diğer adı olan clv ile Clear-Variable da başvurabilirsiniz. Daha fazla bilgi için bkz. about_Aliases.