Rename-Item
Mengganti nama item di namespace penyedia PowerShell.
Sintaks
Rename-Item
[-Path] <String>
[-NewName] <String>
[-Force]
[-PassThru]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Rename-Item
-LiteralPath <String>
[-NewName] <String>
[-Force]
[-PassThru]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Deskripsi
Rename-Item
Cmdlet mengubah nama item tertentu. Cmdlet ini tidak memengaruhi isi item yang diganti namanya.
Anda tidak dapat menggunakan Rename-Item
untuk memindahkan item, seperti dengan menentukan jalur bersama dengan nama baru. Untuk memindahkan dan mengganti nama item, gunakan Move-Item
cmdlet.
Contoh
Contoh 1: Mengganti nama file
Perintah ini mengganti nama file daily_file.txt
menjadi monday_file.txt
.
Rename-Item -Path "c:\logfiles\daily_file.txt" -NewName "monday_file.txt"
Contoh 2: Mengganti nama dan memindahkan item
Anda tidak dapat menggunakan Rename-Item
untuk mengganti nama dan memindahkan item. Secara khusus, Anda tidak dapat menyediakan jalur untuk nilai parameter NewName , kecuali jalurnya identik dengan jalur yang ditentukan dalam parameter Jalur . Jika tidak, hanya nama baru yang diizinkan.
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"
Contoh ini mencoba mengganti nama project.txt
file di direktori saat ini menjadi old-project.txt
di D:\Archive
direktori. Hasilnya adalah kesalahan yang ditunjukkan dalam output.
Move-Item
Gunakan cmdlet, sebagai gantinya.
Contoh 3: Mengganti nama kunci registri
Contoh ini mengganti nama kunci registri dari Iklan ke Pemasaran. Ketika perintah selesai, kunci diganti namanya, tetapi entri registri dalam kunci tidak berubah.
Rename-Item -Path "HKLM:\Software\MyCompany\Advertising" -NewName "Marketing"
Contoh 4: Mengganti nama beberapa file
Contoh ini mengganti nama semua *.txt
file di direktori saat ini menjadi *.log
.
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 mendapatkan semua file di folder saat ini yang memiliki .txt
ekstensi file lalu menyalurkannya ke Rename-Item
. Nilai NewName adalah blok skrip yang berjalan sebelum nilai dikirimkan ke parameter NewName .
Dalam blok skrip, $_
variabel otomatis mewakili setiap objek file saat datang ke perintah melalui alur. Blok skrip menggunakan -replace
operator untuk mengganti ekstensi file dari setiap file dengan .log
. Perhatikan bahwa pencocokan menggunakan -replace
operator tidak peka huruf besar/kecil.
Parameter
-Confirm
Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Catatan
Parameter ini tidak didukung oleh penyedia apa pun yang diinstal dengan PowerShell. Untuk meniru pengguna lain, atau meningkatkan kredensial Anda saat menjalankan cmdlet ini, gunakan Invoke-Command.
Type: | PSCredential |
Position: | Named |
Default value: | Current user |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Force
Memaksa cmdlet untuk mengganti nama item yang tidak dapat diubah, seperti file tersembunyi atau baca-saja atau alias atau variabel baca-saja. Cmdlet tidak dapat mengubah alias atau variabel konstanta. Implementasi bervariasi dari penyedia ke penyedia. Untuk informasi selengkapnya, lihat about_Providers.
Bahkan menggunakan parameter Force , cmdlet tidak dapat mengambil alih pembatasan keamanan.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LiteralPath
Menentukan jalur ke satu atau beberapa lokasi. Nilai LiteralPath digunakan persis seperti yang ditik. Tidak ada karakter yang ditafsirkan sebagai kartubebas. Jika jalur menyertakan karakter escape, sertakan dalam tanda kutip tunggal. Tanda kutip tunggal memberi tahu PowerShell untuk tidak menginterpretasikan karakter apa pun sebagai urutan escape.
Untuk informasi selengkapnya, lihat about_Quoting_Rules.
Type: | String |
Aliases: | PSPath, LP |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NewName
Menentukan nama baru item. Masukkan hanya nama, bukan jalur dan nama. Jika Anda memasukkan jalur yang berbeda dari jalur yang ditentukan dalam parameter Jalur , Rename-Item
menghasilkan kesalahan.
Untuk mengganti nama dan memindahkan item, gunakan Move-Item
.
Anda tidak dapat menggunakan karakter kartubebas dalam nilai parameter NewName . Untuk menentukan nama untuk beberapa file, gunakan operator Ganti dalam ekspresi reguler. Untuk informasi selengkapnya tentang operator Ganti, lihat about_Comparison_Operators.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
Mengembalikan objek yang mewakili item ke alur. Secara default, cmdlet ini tidak menghasilkan output apa pun.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Menentukan jalur item yang akan diganti namanya.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
Anda dapat menyalurkan string yang berisi jalur ke cmdlet ini.
Output
None
Secara default, cmdlet ini tidak mengembalikan output.
Saat Anda menggunakan parameter PassThru , cmdlet ini mengembalikan objek yang mewakili item yang diganti namanya.
Catatan
PowerShell menyertakan alias berikut untuk Rename-Item
:
- Semua platform:
ren
rni
Rename-Item
dirancang untuk bekerja dengan data yang diekspos oleh penyedia mana pun. Untuk mencantumkan penyedia yang tersedia di sesi Anda, ketik Get-PsProvider
. Untuk informasi selengkapnya, lihat about_Providers.
Link Terkait
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk