Rename-Item

Modül:: Microsoft.PowerShell.Management Module

PowerShell sağlayıcı ad alanında bir öğeyi yeniden adlandırır.

Sözdizimi

ByPath EnterprisePublishing

Rename-Item
    [-Path] <String>
    [-NewName] <String>
    [-Force]
    [-PassThru]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByLiteralPath

Rename-Item
    [-NewName] <String>
    -LiteralPath <String>
    [-Force]
    [-PassThru]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Rename-Item cmdlet'i belirtilen öğenin adını değiştirir. Bu cmdlet, yeniden adlandırılan öğenin içeriğini etkilemez.

Yeni adla birlikte bir yol belirterek gibi bir öğeyi taşımak için Rename-Item kullanamazsınız. Öğeyi taşımak ve yeniden adlandırmak için Move-Item cmdlet'ini kullanın.

Örnekler

Örnek 1: Dosyayı yeniden adlandırma

Bu komut daily_file.txt dosyasını monday_file.txtolarak yeniden adlandırır.

Rename-Item -Path "C:\logfiles\daily_file.txt" -NewName "monday_file.txt"

Örnek 2: Öğeyi yeniden adlandırma ve taşıma

Bir öğeyi hem yeniden adlandırmak hem de taşımak için Rename-Item kullanamazsınız. Özellikle, yol Path parametresinde belirtilen yolla aynı olmadığı sürece, NewName parametresinin değeri için bir yol sağlayamazsınız. Aksi takdirde, yalnızca yeni bir isme izin verilir.

Rename-Item -Path "project.txt" -NewName "D:\archive\old-project.txt"

Rename-Item : can't rename because the target specified represents a path or device name.
At line:1 char:12
+ Rename-Item <<<<  -Path project.txt -NewName D:\archive\old-project.txt
+ CategoryInfo          : InvalidArgument: (:) [Rename-Item], PS>  Move-Item -Path "project.txt" -De
stination "D:\archive\old-project.txt"

Bu örnek, geçerli dizindeki project.txt dosyasını old-project.txt dizininde D:\Archive olarak yeniden adlandırmayı dener. Sonuç, çıktıda gösterilen hatadır.

Bunun yerine Move-Item cmdlet'ini kullanın.

Örnek 3: Kayıt defteri anahtarını yeniden adlandırma

Bu örnek, Advertising olan kayıt defteri anahtarını Marketingolarak yeniden adlandırır. Komut tamamlandığında anahtar yeniden adlandırılır, ancak anahtardaki kayıt defteri girdileri değişmez.

Rename-Item -Path "HKLM:\Software\MyCompany\Advertising" -NewName "Marketing"

Örnek 4: Birden çok dosyayı yeniden adlandırma

Bu örnek, geçerli dizindeki tüm *.txt dosyalarını *.logolarak yeniden adlandırır.

Get-ChildItem *.txt

    Directory: C:\temp\files

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        10/3/2019   7:47 AM           2918 Friday.TXT
-a----        10/3/2019   7:46 AM           2918 Monday.Txt
-a----        10/3/2019   7:47 AM           2918 Wednesday.txt

Get-ChildItem *.txt | Rename-Item -NewName { $_.Name -replace '.txt','.log' }
Get-ChildItem *.log

    Directory: C:\temp\files

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        10/3/2019   7:47 AM           2918 Friday.log
-a----        10/3/2019   7:46 AM           2918 Monday.log
-a----        10/3/2019   7:47 AM           2918 Wednesday.log

Get-ChildItem cmdlet'i geçerli klasördeki .txt dosya uzantısına sahip tüm dosyaları alır ve sonra bunları Rename-Item'e aktarır. NewName değeri, değer NewName parametresine gönderilmeden önce çalışan bir betik bloğudur.

Betik bloğunda, $_ otomatik değişkeni, işlem hattı aracılığıyla komuta gelen her dosya nesnesini temsil eder. Betik bloğu, her dosyanın dosya uzantısını -replaceile değiştirmek için .log işlecini kullanır. -replace işleci kullanılarak eşleştirmenin büyük/küçük harfe duyarlı olmadığını unutmayın.

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

-Force

Cmdlet'i gizli veya salt okunur dosyalar ya da salt okunur diğer adlar veya değişkenler gibi başka türlü değiştirilmeyecek öğeleri yeniden adlandırmaya zorlar. Cmdlet sabit diğer adları veya değişkenleri değiştiremez. Uygulama sağlayıcıdan sağlayıcıya değişir. Daha fazla bilgi için bkz. about_Providers.

cmdletForce parametresini kullanarak bile 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

-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

ByLiteralPath

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

-NewName

Öğenin yeni adını belirtir. Yol ve ad değil, yalnızca bir ad girin. Yolu parametresinde belirtilen yoldan farklı bir yol girerseniz Rename-Item bir hata oluşturur. Bir öğeyi yeniden adlandırmak ve taşımak için Move-Itemkullanın.

NewName parametresinin değerinde joker karakterler kullanamazsınız. Birden çok dosya için bir ad belirtmek için normal ifadede -replace işlecini kullanın. -replace işleci hakkında daha fazla bilgi almak için about_Comparison_Operators'ye bakın.

Parametre özellikleri

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

Parametre kümeleri

(All)

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

öğeyi işlem hattına 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:	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

-Path

Yeniden adlandıracak öğenin yolunu belirtir.

Parametre özellikleri

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

Parametre kümeleri

ByPath

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

Bu cmdlet'e bir yolu içeren bir dizeyi aktarabilirsiniz.

Çıkışlar

None

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

PSObject

PassThru parametresini kullandığınızda, bu cmdlet yeniden adlandırılan öğeyi temsil eden bir nesne döndürür.

Notlar

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

Tüm platformlar:
- ren
- rni

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

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Aracılığıyla paylaş

Rename-Item

Sözdizimi

ByPath EnterprisePublishing

ByLiteralPath

Description

Örnekler

Örnek 1: Dosyayı yeniden adlandırma

Örnek 2: Öğeyi yeniden adlandırma ve taşıma

Örnek 3: Kayıt defteri anahtarını yeniden adlandırma

Örnek 4: Birden çok dosyayı yeniden adlandırma

Parametreler

-Confirm

Parametre özellikleri

Parametre kümeleri

-Credential

Parametre özellikleri

Parametre kümeleri

-Force

Parametre özellikleri

Parametre kümeleri

-LiteralPath

Parametre özellikleri

Parametre kümeleri

-NewName

Parametre özellikleri

Parametre kümeleri

-PassThru

Parametre özellikleri

Parametre kümeleri

-Path

Parametre özellikleri

Parametre kümeleri

-WhatIf

Parametre özellikleri

Parametre kümeleri

CommonParameters

Girişler

String

Çıkışlar

None

PSObject

Notlar

İlişkili Bağlantılar

Geri Bildirim