Clear-Item

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

Öğenin içeriğini temizler, ancak öğeyi silmez.

Sözdizimi

Clear-Item
     [-Path] <String[]>
     [-Force]
     [-Filter <String>]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-Credential <PSCredential>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Clear-Item
     -LiteralPath <String[]>
     [-Force]
     [-Filter <String>]
     [-Include <String[]>]
     [-Exclude <String[]>]
     [-Credential <PSCredential>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

Clear-Item Cmdlet bir öğenin içeriğini temizler, ancak öğeyi silmez. Örneğin, Clear-Item cmdlet bir değişkenin değerini silebilir, ancak değişkeni silmez. Temizlenmiş bir öğeyi temsil etmek için kullanılan değer her PowerShell sağlayıcısı tarafından tanımlanır. Bu cmdlet ile benzerdir Clear-Content, ancak dosyalar yerine diğer adlar ve değişkenler üzerinde çalışır.

Örnekler

Örnek 1: Değişkenin değerini temizleme

Bu komut adlı TestVar1değişkenin değerini temizler. Değişken kalır ve geçerlidir, ancak değeri olarak $nullayarlanır. Değişken adı, PowerShell Değişken sağlayıcısını göstermek için ön eke sahiptir Variable: .

Alternatif komutlar, aynı sonucu elde etmek için PowerShell Variable: sürücüsüne geçiş yapabileceğinizi ve ardından komutunu çalıştırabileceğinizi Clear-Item gösterir.

Clear-Item Variable:TestVar1

Set-Location Variable:
PS Variable:\> Clear-Item TestVar1

Örnek 2: Tüm kayıt defteri girdilerini temizleme

Bu komut, "MyKey" alt anahtarındaki tüm kayıt defteri girdilerini temizler, ancak yalnızca amacınızı onaylamanız istendikten sonra. "MyKey" alt anahtarını silmez veya diğer kayıt defteri anahtarlarını veya girdilerini etkilemez. Belirli kayıt defteri anahtarlarını tanımlamak için Include ve Exclude parametrelerini kullanabilirsiniz, ancak bunları kayıt defteri girdilerini tanımlamak için kullanamazsınız.

  • Belirli kayıt defteri girdilerini silmek için cmdlet'ini Remove-ItemProperty kullanın.
  • Kayıt defteri girdisinin değerini silmek için kullanın Clear-ItemProperty cmdlet.
Clear-Item HKLM:\Software\MyCompany\MyKey -Confirm

Parametreler

-Confirm

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

Tür:SwitchParameter
Diğer adlar:cf
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Credential

Not

Bu parametre, PowerShell ile yüklenen hiçbir sağlayıcı tarafından desteklenmez. Başka bir kullanıcının kimliğine bürünmek veya bu cmdlet'i çalıştırırken kimlik bilgilerinizi yükseltmek için Invoke-Command kullanın.

Tür:PSCredential
Position:Named
Default value:Current user
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Exclude

Dize dizisi olarak, bu cmdlet'in işlemde hariç tutulduğu öğeyi veya öğeleri belirtir. Bu parametrenin değeri Path parametresini niteler. gibi *.txtbir yol öğesi veya deseni girin. Joker karakterlere izin verilir. Exclude parametresi yalnızca komutu gibi C:\Windows\*bir öğenin içeriğini içerdiğinde geçerlidir; burada joker karakter dizinin içeriğini C:\Windows belirtir.

Tür:String[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:True

-Filter

Path parametresini nitelemek için bir filtre belirtir. FileSystem sağlayıcısı, filtrelerin kullanımını destekleyen tek yüklü PowerShell sağlayıcısıdır. FileSystem filtre dilinin söz dizimini about_Wildcards bulabilirsiniz. Filtreler diğer parametrelerden daha verimlidir, çünkü sağlayıcı, nesneleri aldıktan sonra PowerShell'in filtrelemesini yapmak yerine cmdlet nesneleri aldığında bunları uygular.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:True

-Force

Cmdlet'in salt okunur diğer adlar gibi başka türlü değiştirilemeyen öğeleri temizlediğini gösterir. Cmdlet sabitleri temizleyemez. Uygulama sağlayıcıdan sağlayıcıya değişir. Daha fazla bilgi için bkz . about_Providers. Cmdlet, Force parametresi kullanılsa bile güvenlik kısıtlamalarını geçersiz kılamaz.

Tür:SwitchParameter
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Include

Dize dizisi olarak, bu cmdlet'in işleme dahil olduğu öğeyi veya öğeleri belirtir. Bu parametrenin değeri Path parametresini niteler. gibi "*.txt"bir yol öğesi veya deseni girin. Joker karakterlere izin verilir. Include parametresi yalnızca komutu gibi C:\Windows\*bir öğenin içeriğini içerdiğinde geçerlidir; burada joker karakter dizinin içeriğini C:\Windows belirtir.

Tür:String[]
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:True

-LiteralPath

Bir veya daha fazla konumun yolunu belirtir. LiteralPath değeri tam olarak yazıldığı gibi kullanılır. Hiçbir karakter joker karakter olarak yorumlanmamıştır. Yol kaçış karakterleri içeriyorsa, tek tırnak içine alın. Tek tırnak işaretleri PowerShell'e hiçbir karakteri kaçış dizisi olarak yorumlamaması gerektiğini söyler.

Daha fazla bilgi için bkz . about_Quoting_Rules.

Tür:String[]
Diğer adlar:PSPath, LP
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Path

Temizlenen öğelerin yolunu belirtir. Joker karakterlere izin verilir. Bu parametre gereklidir, ancak Path parametre adı isteğe bağlıdır.

Tür:String[]
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:True

-WhatIf

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

Tür:SwitchParameter
Diğer adlar:wi
Position:Named
Default value:False
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

String

Bir yol dizesini bu cmdlet'e yöneltebilirsiniz.

Çıkışlar

None

Bu cmdlet çıkış döndürmez.

Notlar

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

  • Tüm platformlar:

    • cli

  • Clear-Item Cmdlet yalnızca Diğer Ad, Ortam, İşlev, Kayıt Defteri ve Değişken sağlayıcıları dahil olmak üzere çeşitli PowerShell sağlayıcıları tarafından desteklenir. Bu nedenle, sağlayıcı ad alanındaki öğelerin içeriğini silmek için kullanabilirsiniz Clear-Item . Oturumunuzda kullanılabilen sağlayıcıları listelemek için yazın Get-PsProvider. Daha fazla bilgi için bkz . about_Providers.

  • PowerShell FileSystem sağlayıcısı bu cmdlet'i desteklemediğinden dosyasının içeriğini silmek için kullanamazsınız Clear-Item . Dosyaları temizlemek için kullanın Clear-Content.