Dela via

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]
      [-UseTransaction]
      [<CommonParameters>]
Rename-Item
      -LiteralPath <String>
      [-NewName] <String>
      [-Force]
      [-PassThru]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [-UseTransaction]
      [<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 Path. I annat fall tillåts endast ett nytt namn.

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.

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"

Exempel 3: Byt namn på en registernyckel

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"

Exempel 4: Byt namn på flera filer

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.

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

Not

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 om du använder parametern Force 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
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 Path genererar Rename-Item 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

-UseTransaction

Innehåller kommandot i den aktiva transaktionen. Den här parametern är endast giltig när en transaktion pågår. Mer information finns i about_Transactions.

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

-WhatIf

Visar vad som skulle hända om cmdleten körs. 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 or an object that represents the renamed item.

Den här cmdleten genererar ett objekt som representerar det omdöpta objektet, om du anger parametern PassThru. Annars genererar den här cmdleten inga utdata.

Kommentarer

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 about_Providers.