Aracılığıyla paylaş

Rename-ItemProperty

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

Bir öğenin özelliğini yeniden adlandırır.

Sözdizimi

Rename-ItemProperty
      [-Path] <String>
      [-Name] <String>
      [-NewName] <String>
      [-PassThru]
      [-Force]
      [-Filter <String>]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [-UseTransaction]
      [<CommonParameters>]
Rename-ItemProperty
      -LiteralPath <String>
      [-Name] <String>
      [-NewName] <String>
      [-PassThru]
      [-Force]
      [-Filter <String>]
      [-Include <String[]>]
      [-Exclude <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [-UseTransaction]
      [<CommonParameters>]

Description

Cmdlet, Rename-ItemProperty belirtilen öğe özelliğinin adını değiştirir. özelliğinin değeri değiştirilmez. Örneğin, bir kayıt defteri girdisinin adını değiştirmek için kullanabilirsiniz Rename-ItemProperty .

Örnekler

Örnek 1: Kayıt defteri girdilerini yeniden adlandırma

Bu komut, "HKEY_LOCAL_MACHINE\Software\SmpApplication" anahtarındaki yapılandırma kayıt defteri girdisini "oldconfig" olarak yeniden adlandırır.

Rename-ItemProperty -Path HKLM:\Software\SmpApplication -Name config -NewName oldconfig

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

Bu eylemi gerçekleştirme iznine sahip bir kullanıcı hesabı belirtir. Varsayılan, mevcut kullanıcıdır.

"User01" veya "Domain01\User01" gibi bir kullanıcı adı yazın veya cmdlet tarafından Get-Credential oluşturulan nesne gibi bir PSCredential nesnesi girin. Bir kullanıcı adı yazarsanız parola girmeniz istenir.

Uyarı

Bu parametre, Windows PowerShell ile yüklenen hiçbir sağlayıcı tarafından desteklenmez.

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

-Exclude

Bu cmdlet'in atlayan öğeleri belirtir. Bu parametrenin değeri Path parametresini niteler. "*.txt" gibi bir yol öğesi veya deseni girin. Joker karakterlere izin verilir.

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

-Filter

Sağlayıcının biçiminde veya dilinde bir filtre belirtir. Bu parametrenin değeri Path parametresini niteler.

Joker karakterlerin kullanımı da dahil olmak üzere filtrenin söz dizimi sağlayıcıya bağlıdır. 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'i, kullanıcı tarafından erişilemeyen bir nesnenin özelliğini yeniden adlandırmaya zorlar. Uygulama sağlayıcıdan sağlayıcıya değişir. Daha fazla bilgi için bkz . about_Providers.

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

-Include

Yalnızca cmdlet'in diğer tüm öğeleri hariç tutarak üzerinde hareket ettiği öğeleri belirtir. Bu parametrenin değeri Path parametresini niteler. "*.txt" gibi bir yol öğesi veya deseni girin. Joker karakterlere izin verilir.

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

-LiteralPath

Öğenin yolunu belirtir. Path parametresinden farklı olarak, 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.

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

-Name

Yeniden adlandıracak özelliğin geçerli adını belirtir.

Tür:String
Diğer adlar:PSProperty
Position:1
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-NewName

Özelliğin yeni adını belirtir.

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

-PassThru

Item özelliğini temsil eden bir nesne döndürür. Varsayılan olarak, bu cmdlet herhangi bir çıkış oluşturmaz.

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

-Path

Öğenin yolunu belirtir.

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

-UseTransaction

Komutunu etkin işleme ekler. Bu parametre yalnızca bir işlem devam ederken geçerlidir. Daha fazla bilgi için bkz . about_Transactions.

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

-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

Bu cmdlet'e yol içeren ancak değişmez yol içermeyen bir dizeyi kanala aktarabilirsiniz.

Çıkışlar

None

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

PSCustomObject

PassThru parametresini kullandığınızda, bu cmdlet yeniden adlandırılan öğe özelliğini temsil eden bir PSCustomObject döndürür.

Notlar

Windows PowerShell için aşağıdaki diğer adları Rename-ItemPropertyiçerir:

  • rnp

Rename-ItemProperty herhangi bir sağlayıcı tarafından kullanıma sunulan verilerle çalışacak şekilde tasarlanmıştır. Oturumunuzda kullanılabilen sağlayıcıları listelemek için yazın Get-PSProvider. Daha fazla bilgi için bkz . about_Providers.