Rename-Item

  • Referentie
Module:
Microsoft.PowerShell.Management

Hiermee wijzigt u de naam van een item in een PowerShell-providernaamruimte.

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

De Rename-Item cmdlet wijzigt de naam van een opgegeven item. Deze cmdlet heeft geen invloed op de inhoud van het item waarvan de naam wordt gewijzigd.

U kunt een item niet Rename-Item verplaatsen, bijvoorbeeld door een pad op te geven samen met de nieuwe naam. Gebruik de cmdlet om een item te verplaatsen en de Move-Item naam ervan te wijzigen.

Voorbeelden

Voorbeeld 1: De naam van een bestand wijzigen

Met deze opdracht wordt de naam van het bestand daily_file.txt gewijzigd in monday_file.txt.

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

Voorbeeld 2: De naam van een item wijzigen en verplaatsen

U kunt de naam van een item niet Rename-Item wijzigen en verplaatsen. U kunt met name geen pad opgeven voor de waarde van de parameter NewName , tenzij het pad identiek is aan het pad dat is opgegeven in de parameter Path . Anders is alleen een nieuwe naam toegestaan.

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"

In dit voorbeeld wordt geprobeerd de naam van het project.txt bestand in de huidige map te old-project.txt wijzigen in de D:\Archive map. Het resultaat is de fout die wordt weergegeven in de uitvoer.

Gebruik in plaats daarvan de Move-Item cmdlet.

Voorbeeld 3: De naam van een registersleutel wijzigen

In dit voorbeeld wordt de naam van een registersleutel gewijzigd van Advertising to Marketing. Wanneer de opdracht is voltooid, wordt de naam van de sleutel gewijzigd, maar de registervermeldingen in de sleutel blijven ongewijzigd.

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

Voorbeeld 4: De naam van meerdere bestanden wijzigen

In dit voorbeeld worden alle *.txt bestanden in de huidige map gewijzigd in *.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

De Get-ChildItem cmdlet haalt alle bestanden op in de huidige map met een .txt bestandsextensie en krijgt deze vervolgens door.Rename-Item De waarde van NewName is een scriptblok dat wordt uitgevoerd voordat de waarde wordt verzonden naar de parameter NewName .

In het scriptblok vertegenwoordigt de $_ automatische variabele elk bestandsobject als het gaat om de opdracht via de pijplijn. Het scriptblok gebruikt de -replace operator om de bestandsextensie van elk bestand te vervangen door .log. U ziet dat overeenkomsten met behulp van de -replace operator niet hoofdlettergevoelig zijn.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Notitie

Deze parameter wordt niet ondersteund door providers die zijn geïnstalleerd met PowerShell. Als u een andere gebruiker wilt imiteren of uw referenties wilt verhogen bij het uitvoeren van deze cmdlet, gebruikt u Invoke-Command.

Type:PSCredential
Position:Named
Default value:Current user
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Force

Dwingt de cmdlet om de naam van items te wijzigen die anders niet kunnen worden gewijzigd, zoals verborgen of alleen-lezen bestanden of alleen-lezen aliassen of variabelen. De cmdlet kan geen constante aliassen of variabelen wijzigen. Implementatie varieert van provider tot provider. Zie about_Providers voor meer informatie.

Zelfs met de parameter Force kan de cmdlet geen beveiligingsbeperkingen overschrijven.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LiteralPath

Hiermee geeft u een pad naar een of meer locaties. De waarde van LiteralPath wordt exact gebruikt zoals deze is getypt. Er worden geen tekens geïnterpreteerd als jokertekens. Als het pad escapetekens bevat, plaatst u het tussen enkele aanhalingstekens. Enkele aanhalingstekens geven PowerShell aan dat er geen tekens als escapereeksen moeten worden geïnterpreteerd.

Zie about_Quoting_Rules voor meer informatie.

Type:String
Aliases:PSPath, LP
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NewName

Hiermee geeft u de nieuwe naam van het item. Voer alleen een naam in, geen pad en naam. Als u een pad invoert dat verschilt van het pad dat is opgegeven in de parameter Path , Rename-Item genereert u een fout. Als u de naam van een item wilt wijzigen en verplaatsen, gebruikt u Move-Item.

U kunt geen jokertekens gebruiken in de waarde van de parameter NewName . Als u een naam voor meerdere bestanden wilt opgeven, gebruikt u de operator Vervangen in een reguliere expressie. Zie about_Comparison_Operators voor meer informatie over de operator Replace.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Hiermee wordt een object geretourneerd dat het item aan de pijplijn vertegenwoordigt. Deze cmdlet genereert standaard geen uitvoer.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Hiermee geeft u het pad van het item waarvan u de naam wilt wijzigen.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

String

U kunt een tekenreeks met een pad naar deze cmdlet doorsluisen.

Uitvoerwaarden

None

Deze cmdlet retourneert standaard geen uitvoer.

PSObject

Wanneer u de parameter PassThru gebruikt, retourneert deze cmdlet een object dat het hernoemde item vertegenwoordigt.

Notities

PowerShell bevat de volgende aliassen voor Rename-Item:

  • Alle platforms:
    • ren
    • rni

Rename-Item is ontworpen om te werken met de gegevens die door elke provider worden weergegeven. Als u de providers wilt weergeven die beschikbaar zijn in uw sessie, typt Get-PsProvideru . Zie about_Providers voor meer informatie.