Rename-Item

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

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

Cmdleten Rename-Item ändrar namnet på ett angivet objekt. Den här cmdleten påverkar inte innehållet i objektet som byter namn.

Du kan inte använda Rename-Item för att flytta ett objekt, till exempel genom att ange en sökväg tillsammans med det nya namnet. Om du vill flytta och byta namn på ett objekt använder du cmdleten Move-Item.

Det här kommandot byter namn på filen daily_file.txt till monday_file.txt.

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

Du kan inte använda Rename-Item för att både byta namn på och flytta ett objekt. Mer specifikt kan du inte ange en sökväg för värdet för parametern NewName, såvida inte sökvägen är identisk med sökvägen som anges i parametern Path. I annat fall tillåts endast ett nytt namn.

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"

Det här exemplet försöker byta namn på den project.txt filen i den aktuella katalogen till old-project.txt i katalogen D:\Archive. Resultatet är det fel som visas i utdata.

Använd i stället cmdleten Move-Item.

Det här exemplet byter namn på en registernyckel från Advertising till Marketing. När kommandot är klart byts nyckeln namn, men registerposterna i nyckeln är oförändrade.

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

Det här exemplet byter namn på alla *.txt filer i den aktuella katalogen till *.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

Cmdleten Get-ChildItem hämtar alla filer i den aktuella mappen som har ett .txt filnamnstillägg och skickar dem sedan till Rename-Item. Värdet för NewName är ett skriptblock som körs innan värdet skickas till parametern NewName.

I skriptblocket representerar den $_ automatiska variabeln varje filobjekt när det gäller kommandot via pipelinen. Skriptblocket använder -replace-operatorn för att ersätta filnamnstillägget för varje fil med .log. Observera att matchning med operatorn -replace inte är skiftlägeskänslig.

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Du kan skicka en sträng som innehåller en sökväg till den här cmdleten.

Som standard returnerar den här cmdleten inga utdata.

När du använder parametern PassThru returnerar den här cmdleten ett objekt som representerar det omdöpta objektet.

PowerShell innehåller följande alias för Rename-Item:

• Alla plattformar:
  • ren
  • rni

Rename-Item är utformat för att fungera med data som exponeras av alla leverantörer. Om du vill visa en lista över tillgängliga leverantörer i sessionen skriver du Get-PSProvider. Mer information finns i om_Leverantörer.