Rename-Item

  • Referens
Modul:
Microsoft.PowerShell.Management

Byter namn på ett objekt i ett PowerShell-providernamnområde.

Syntax

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>]

Description

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 .

Exempel

Exempel 1: Byt namn på en fil

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"

Exempel 2: Byt namn på och flytta ett objekt

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 Sökväg . 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å project.txt filen i den aktuella katalogen till old-project.txt i D:\Archive katalogen. Resultatet är det fel som visas i utdata.

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

Exempel 3: Byt namn på en registernyckel

Det här exemplet byter namn på en registernyckel från Reklam till Marknadsföring. 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"

Exempel 4: Byt namn på flera filer

Det här exemplet byter namn på *.txt alla 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 operatorn -replace för att ersätta filnamnstillägget för varje fil med .log. Observera att matchning med operatorn -replace inte är skiftlägeskänslig.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Credential

Kommentar

Den här parametern stöds inte av några leverantörer som är installerade med PowerShell. Om du vill personifiera en annan användare eller höja dina autentiseringsuppgifter när du kör den här cmdleten använder du Invoke-Command.

Typ:PSCredential
Position:Named
Standardvärde:Current user
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Force

Tvingar cmdleten att byta namn på objekt som annars inte kan ändras, till exempel dolda eller skrivskyddade filer eller skrivskyddade alias eller variabler. Cmdleten kan inte ändra konstanta alias eller variabler. Implementeringen varierar från leverantör till leverantör. Mer information finns i about_Providers.

Även med hjälp av force-parametern kan cmdleten inte åsidosätta säkerhetsbegränsningar.

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-LiteralPath

Anger en sökväg till en eller flera platser. Värdet för LiteralPath används exakt som det skrivs. Inga tecken tolkas som jokertecken. Om sökvägen innehåller escape-tecken omger du den med enkla citattecken. Enkla citattecken gör att PowerShell inte tolkar några tecken som escape-sekvenser.

Mer information finns i about_Quoting_Rules.

Typ:String
Alias:PSPath, LP
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-NewName

Anger det nya namnet på objektet. Ange bara ett namn, inte en sökväg och ett namn. Om du anger en sökväg som skiljer sig från sökvägen som anges i parametern Rename-Item Sökväg genererar ett fel. Om du vill byta namn på och flytta ett objekt använder du Move-Item.

Du kan inte använda jokertecken i värdet för parametern NewName . Om du vill ange ett namn för flera filer använder du operatorn Ersätt i ett reguljärt uttryck. Mer information om operatorn Ersätt finns i about_Comparison_Operators.

Typ:String
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-PassThru

Returnerar ett objekt som representerar objektet till pipelinen. Som standard genererar den här cmdleten inga utdata.

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Path

Anger sökvägen till objektet som ska byta namn.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

String

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

Utdata

None

Som standard returnerar den här cmdleten inga utdata.

PSObject

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

Kommentarer

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

  • Alla plattformar:
    • ren
    • rni

Rename-Item är utformad 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 about_Providers.