Partager via

Rename-Item

Module:
Microsoft.PowerShell.Management Module

Renomme un élément dans un espace de noms de fournisseur PowerShell.

Syntaxe

ByPath (Par défaut) 

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

ByLiteralPath 

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

Description

L’applet de commande Rename-Item modifie le nom d’un élément spécifié. Cette applet de commande n’affecte pas le contenu de l’élément 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 commande Move-Item.

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 fichier project.txt dans le répertoire actif en old-project.txt dans le répertoire D:\Archive. Le résultat est l’erreur affichée dans la sortie.

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

Exemple 3 : Renommer une clé de Registre

Cet exemple renomme une clé de registre de Advertising en Marketing. Une fois la commande terminée, la clé est renommée, mais les entrées de Registre de la clé sont inchangées.

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

Exemple 4 : Renommer plusieurs fichiers

Cet exemple renomme tous les fichiers *.txt dans le 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 de commande Get-ChildItem obtient tous les fichiers du dossier actif qui ont une extension de fichier .txt, 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 à mesure qu'il arrive à la commande via le pipeline. Le bloc de script utilise l’opérateur -replace pour remplacer l’extension de fichier de chaque fichier par .log. Notez que la correspondance avec l’opérateur -replace ne respecte pas la casse.

Paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Credential

Remarque

Ce paramètre n’est pas pris en charge par les fournisseurs installés avec PowerShell. Pour emprunter l’identité d’un autre utilisateur ou élever vos informations d’identification lors de l’exécution de cette applet de commande, utilisez Invoke-Command.

Propriétés du paramètre

Type:PSCredential
Valeur par défaut:Current user
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Force

Force l’applet de commande à renommer les éléments qui ne peuvent pas être modifiés autrement, tels que les fichiers masqués ou en lecture seule ou les alias ou variables en lecture seule. L’applet de commande ne peut pas modifier les alias de constantes ou les variables. L’implémentation varie du fournisseur au fournisseur. Pour plus d’informations, voir about_Providers.

Même en utilisant le paramètre Force, le cmdlet ne peut pas remplacer les restrictions de sécurité.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-LiteralPath

Spécifie un chemin d’accès à un ou plusieurs emplacements. La valeur de LiteralPath est utilisée exactement comme elle est typée. Aucun caractère n’est interprété en tant que caractère générique. Si le chemin d’accès inclut des caractères d’échappement, mettez-le entre des guillemets simples. Les guillemets simples indiquent à PowerShell de ne pas interpréter de caractères comme séquences d’échappement.

Pour plus d'informations, consultez la section sur les règles de citation.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:PSPath

Jeux de paramètres

ByLiteralPath
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-NewName

Spécifie le nouveau nom de l’élément. Entrez uniquement un nom, et non un chemin d’accès et un nom. Si vous entrez un chemin qui diffère du chemin spécifié dans le paramètre path, Rename-Item génère une erreur. Pour renommer et déplacer un élément, utilisez Move-Item.

Vous ne pouvez pas utiliser de caractères génériques dans la valeur du paramètre NewName. Pour spécifier un nom pour plusieurs fichiers, utilisez l’opérateur -replace dans une expression régulière. Pour plus d'informations sur l'opérateur -replace, consultez à propos des opérateurs de comparaison.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:1
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-PassThru

Retourne un objet qui représente l’élément au pipeline. Par défaut, cette applet de commande ne génère aucune sortie.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Path

Spécifie le chemin d’accès de l’élément à renommer.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ByPath
Position:0
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-UseTransaction

Inclut la commande dans la transaction active. Ce paramètre est valide uniquement lorsqu’une transaction est en cours. Pour plus d’informations, consultez about_Transactions.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:usetx

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

String

Vous pouvez acheminer une chaîne contenant un chemin vers 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

Windows PowerShell inclut les alias suivants pour Rename-Item:

  • 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, voir about_Providers.