Rename-Item
重新命名PowerShell提供者命名空間中的專案。
語法
Rename-Item
[-Path] <String>
[-NewName] <String>
[-Force]
[-PassThru]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
Rename-Item
-LiteralPath <String>
[-NewName] <String>
[-Force]
[-PassThru]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[-UseTransaction]
[<CommonParameters>]
Description
Cmdlet 會 Rename-Item
變更指定項目的名稱。 此 Cmdlet 不會影響要重新命名之項目的內容。
您無法使用 Rename-Item
來移動專案,例如藉由指定路徑與新名稱。 若要移動並重新命名專案,請使用 Move-Item
Cmdlet。
範例
範例 1:重新命名檔案
這個指令會將檔案 daily_file.txt
重新命名為 monday_file.txt
。
Rename-Item -Path "c:\logfiles\daily_file.txt" -NewName "monday_file.txt"
範例 2:重新命名和行動專案
您無法同時使用 Rename-Item
來重新命名和行動專案。 具體來說,除非 path 與 Path 參數中指定的路徑相同,否則您無法提供 NewName 參數值的路徑。 否則,只允許新的名稱。
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"
此範例會嘗試將目前目錄中的檔案重新命名 project.txt
為 old-project.txt
目錄中的 D:\Archive
檔案。 結果是輸出中顯示的錯誤。
請改用 Move-Item
Cmdlet。
範例 3:重新命名登錄機碼
本範例會將登錄機碼從 Advertising 重新命名為 Marketing。 當命令完成時,會重新命名機碼,但機碼中的登錄專案不會變更。
Rename-Item -Path "HKLM:\Software\MyCompany\Advertising" -NewName "Marketing"
範例 4:重新命名多個檔案
本範例會將目前目錄中的所有 *.txt
檔案重新命名為 *.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
Cmdlet 會 Get-ChildItem
取得目前資料夾中擴展名 .txt
為 的所有檔案,然後將這些檔案傳送至 Rename-Item
。 NewName 的值是腳本區塊,會在將值提交至 NewName 參數之前執行。
在腳本區塊中 $_
,自動變數代表每個檔案對象,因為它會透過管線傳送命令。 文稿區塊會使用 -replace
運算子,將每個檔案的擴展名取代為 .log
。 請注意,使用 運算符比對 -replace
不區分大小寫。
參數
-Confirm
執行 Cmdlet 之前先提示您確認。
類型: | SwitchParameter |
別名: | cf |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Credential
注意
任何與 PowerShell 一起安裝的提供者都不支援此參數。 若要模擬其他使用者,或在執行此 Cmdlet 時提升您的認證,請使用 Invoke-Command。
類型: | PSCredential |
Position: | Named |
預設值: | Current user |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
-Force
強制 Cmdlet 重新命名無法變更的專案,例如隱藏或只讀檔案或唯讀別名或變數。 Cmdlet 無法變更常數別名或變數。 實作會因提供者而異。 如需詳細資訊,請參閱 about_Providers。
即使使用 Force 參數,Cmdlet 也無法覆寫安全性限制。
類型: | SwitchParameter |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-LiteralPath
指定一或多個位置的路徑。 LiteralPath 的值會與類型完全相同使用。 不會將任何字元解譯為通配符。 如果路徑包含逸出字元,請以單引弧括住它。 單引號會告知PowerShell不要將任何字元解譯為逸出序列。
如需詳細資訊,請參閱 about_Quoting_Rules。
類型: | String |
別名: | PSPath |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-NewName
指定專案的新名稱。 只輸入名稱,而不是路徑和名稱。 如果您輸入的路徑與Path參數中指定的路徑不同,Rename-Item
則會產生錯誤。
若要重新命名與移動專案, 請使用 Move-Item
。
您無法在 NewName 參數的值中使用通配符。 若要指定多個檔案的名稱,請在正則表示式中使用 Replace 運算子。 如需 Replace 運算子的詳細資訊,請參閱 about_Comparison_Operators。
類型: | String |
Position: | 1 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-PassThru
傳回 物件,表示管線的專案。 根據預設,此 Cmdlet 不會產生任何輸出。
類型: | SwitchParameter |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Path
指定要重新命名之項目的路徑。
類型: | String |
Position: | 0 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-UseTransaction
在作用中交易中包含 命令。 只有在交易進行中時,此參數才有效。 如需詳細資訊,請參閱 about_Transactions。
類型: | SwitchParameter |
別名: | usetx |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。
類型: | SwitchParameter |
別名: | wi |
Position: | Named |
預設值: | False |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
輸入
您可以使用管線傳送包含此 Cmdlet 路徑的字串。
輸出
None
根據預設,此 Cmdlet 不會傳回任何輸出。
當您使用 PassThru 參數時,這個 Cmdlet 會傳回代表已重新命名項目的物件。
備註
Windows PowerShell 包含下列的 Rename-Item
別名:
ren
rni
Rename-Item
是設計來使用任何提供者所公開的數據。 若要列出工作階段中可用的提供者,請輸入 Get-PsProvider
。 如需詳細資訊,請參閱 about_Providers。