Rename-Item

模組:: Microsoft.PowerShell.Management Module

重新命名PowerShell提供者命名空間中的專案。

語法

ByPath (預設值)

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 會變更指定項目的名稱。此 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 參數中指定的路徑相同，否則您無法提供 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

Get-ChildItem Cmdlet 會取得目前資料夾中具有 .txt 擴展名的所有檔案，然後將這些檔案傳送至 Rename-Item。 NewName 的值是一個腳本區塊，會在將值提交至 NewName 參數之前執行。

在腳本段落中，$_ 自動變數表示每個檔案物件在通過管線並抵達命令時的狀態。文稿區塊會使用 -replace 運算子，將每個檔案的擴展名取代為 .log。請注意，使用 -replace 運算符比對不區分大小寫。

參數

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False
別名:	cf

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Credential

備註

任何與 PowerShell 一起安裝的提供者都不支援此參數。若要模擬其他使用者，或在執行此 Cmdlet 時提升您的認證，請使用 Invoke-Command。

參數屬性

類型:	PSCredential
預設值:	Current user
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-Force

強制 Cmdlet 重新命名無法變更的專案，例如隱藏或只讀檔案或唯讀別名或變數。 Cmdlet 無法變更常數別名或變數。實作會因提供者而異。如需詳細資訊，請參閱 about_Providers。

即使使用 Force 參數，Cmdlet 也無法覆蓋安全性限制。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-LiteralPath

指定通往一個或多個位置的路徑。 LiteralPath 的值會按原本輸入的方式使用。不會將任何字元解譯為通配符。如果路徑包含逸出字元，請以單引弧括住它。單引號會告知PowerShell不要將任何字元解譯為逸出序列。

如需詳細資訊，請參閱 about_Quoting_Rules。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False
別名:	PSPath, LP

參數集

ByLiteralPath

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-NewName

指定專案的新名稱。只輸入名稱，而不是路徑和名稱。如果您輸入的路徑與 Path 參數中指定的路徑不同，Rename-Item 會產生錯誤。若要重新命名和移動專案，請使用 Move-Item。

您無法在 NewName 參數的值中使用通配符。若要指定多個檔案的名稱，請在正則表示式中使用 -replace 運算符。如需 -replace 運算子的詳細資訊，請參閱 about_Comparison_Operators。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	1
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-PassThru

傳回一個物件，代表管道中的項目。根據預設，此 Cmdlet 不會產生任何輸出。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Path

指定要重新命名之項目的路徑。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ByPath

Position:	0
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。指令未執行。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False
別名:	無線

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。如需詳細資訊，請參閱 about_CommonParameters。

輸入

String

您可以傳送包含路徑的字串到此 Cmdlet。

輸出

None

根據預設，此 Cmdlet 不會傳回任何輸出。

PSObject

當您使用 PassThru 參數時，這個 Cmdlet 會傳回代表已重新命名項目的物件。

備註

PowerShell 包含下列 Rename-Item的別名：

所有平臺：
- ren
- rni

Rename-Item 的設計目的是要處理任何提供者所公開的數據。若要列出工作階段中可用的提供者，請輸入 Get-PSProvider。如需詳細資訊，請參閱 about_Providers。

意見反應

此頁面對您有幫助嗎？

共用方式為

Rename-Item

語法

ByPath (預設值)

ByLiteralPath

Description

範例

範例 1：重新命名檔案

範例 2：重新命名並移動一個項目

範例 3：重新命名登錄機碼

範例 4：重新命名多個檔案

參數

-Confirm

參數屬性

參數集

-Credential

參數屬性

參數集

-Force

參數屬性

參數集

-LiteralPath

參數屬性

參數集

-NewName

參數屬性

參數集

-PassThru

參數屬性

參數集

-Path

參數屬性

參數集

-WhatIf

參數屬性

參數集

CommonParameters

輸入

String

輸出

None

PSObject

備註

相關連結

意見反應