Clear-Item

Modül:

Microsoft.PowerShell.Management Module

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

Sözdizimi

Path EnterprisePublishing

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

LiteralPath

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

Description

Clear-Item cmdlet'i bir öğenin içeriğini temizler, ancak öğeyi silmez. Örneğin, Clear-Item cmdlet'i 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 Clear-Contentbenzer, ancak dosyalar yerine diğer adlar ve değişkenler üzerinde çalışır.

Örnekler

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

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

Alternatif komutlar, aynı sonucu elde etmek için PowerShell Variable: sürücüsüne geçebileceğinizi ve ardından Clear-Item komutunu çalıştırabileceğinizi 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 Remove-ItemProperty cmdlet'ini kullanın.
• Kayıt defteri girdisinin değerini silmek için Clear-ItemProperty cmdletkullanın.

Clear-Item HKLM:\Software\MyCompany\MyKey -Confirm

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

-Credential

Uyarı

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-Commandkullanın.

Parametre özellikleri

Tür:	PSCredential
Default value:	Current user
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:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Exclude

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

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

-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özdizimini about_Wildcards'de 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.

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, normalde değiştirilemeyen öğeleri, örneğin salt okunur diğer adları 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. Force parametresi kullanıldığında bile cmdlet güvenlik kısıtlamalarını geçersiz kılamaz.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
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

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

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

-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, yolu tek tırnak işaretleriyle çevreleyin. Tek tırnak işaretleri, PowerShell'in hiçbir karakteri kaçış dizisi olarak yorumlamamasını sağlar.

Daha fazla bilgi için bkz. about_Quoting_Rules.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	PSPath, LP

Parametre kümeleri

LiteralPath

Position:	Named
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

-Path

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

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	True
DontShow:	False

Parametre kümeleri

Path

Position:	0
Zorunlu:	True
İşlem hattından gelen değer:	True
Ö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

-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

String

Bir yol dizesini bu cmdlet'e yöneltebilirsiniz.

Çıkışlar

None

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

Notlar

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

• Tüm platformlar:

  • cli

• Clear-Item cmdlet'i yalnızca Diğer Ad, Ortam, İşlev, Kayıt Defterive 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 Clear-Item kullanabilirsiniz. Oturumunuzda kullanılabilen sağlayıcıları listelemek için Get-PSProvideryazın. Daha fazla bilgi için bkz. about_Providers.

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

İlişkili Bağlantılar

• Öğe Kopyala
• Get-Item
• Invoke-Item
• Öğeyi Taşı
• Yeni Öğe
• Ögeyi Kaldır
• Öğeyi Yeniden Adlandır
• Set-Item komutu
• Sağlayıcılar_Hakkında