Rename-Item

Syntaxe

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

L’applet Rename-Item de commande modifie le nom d’un élément spécifié. Cette applet de commande n’affecte pas le contenu de l’élément qui est renommé.

Vous ne pouvez pas utiliser Rename-Item pour déplacer un élément, par exemple en spécifiant un chemin d’accès avec le nouveau nom. Pour déplacer et renommer un élément, utilisez l’applet de Move-Item commande.

Exemples

Exemple 1 : Renommer un fichier

Cette commande renomme le fichier daily_file.txt en monday_file.txt.

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

Exemple 2 : Renommer et déplacer un élément

Vous ne pouvez pas utiliser Rename-Item pour renommer et déplacer un élément. Plus précisément, vous ne pouvez pas fournir de chemin d’accès pour la valeur du paramètre NewName , sauf si le chemin d’accès est identique au chemin spécifié dans le paramètre Path . Sinon, seul un nouveau nom est autorisé.

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"

Cet exemple tente de renommer le project.txt fichier dans le répertoire old-project.txt actif dans le D:\Archive répertoire. Il en résulte l’erreur indiquée dans la sortie.

Utilisez plutôt l’applet Move-Item de commande.

Exemple 3 : Renommer une clé de Registre

Cet exemple renomme une clé de Registre de Publicité en Marketing. Une fois la commande exécutée, la clé est renommée, mais les entrées de Registre qui figurent dans la clé demeurent inchangées.

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

Exemple 4 : Renommer plusieurs fichiers

Cet exemple renomme tous les *.txt fichiers du répertoire actif en *.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

L’applet Get-ChildItem de commande obtient tous les fichiers du dossier actif qui ont une .txt extension de fichier, puis les canalise vers Rename-Item. La valeur de NewName est un bloc de script qui s’exécute avant l’envoi de la valeur au paramètre NewName.

Dans le bloc de script, la $_ variable automatique représente chaque objet de fichier tel qu’il s’agit de la commande via le pipeline. Le bloc de script utilise l’opérateur -replace pour remplacer l’extension de fichier de chaque fichier .logpar . Notez que la correspondance à l’aide de l’opérateur n’est pas sensible à la -replace casse.

Paramètres

-Confirm

-Credential

-Force

-LiteralPath

-NewName

-PassThru

-Path

-WhatIf

Entrées

String

Vous pouvez diriger une chaîne qui contient un chemin d’accès à cette applet de commande.

Sorties

None

Par défaut, cette applet de commande ne retourne aucune sortie.

PSObject

Lorsque vous utilisez le paramètre PassThru , cette applet de commande retourne un objet représentant l’élément renommé.

Notes

PowerShell inclut les alias suivants pour Rename-Item:

• Toutes les plateformes :
  • ren
  • rni

Rename-Item est conçu pour fonctionner avec les données exposées par n’importe quel fournisseur. Pour répertorier les fournisseurs disponibles dans votre session, tapez Get-PsProvider. Pour plus d’informations, consultez about_Providers.

Liens associés

• Clear-Item
• Copy-Item
• Get-ChildItem
• Get-Item
• Invoke-Item
• Move-Item
• New-Item
• Remove-Item
• Rename-ItemProperty
• Set-Item
• about_Providers