Move-Item

Move-Item
    [-Path] <String[]>
    [[-Destination] <String>]
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-PassThru]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [<CommonParameters>]

Move-Item
    [[-Destination] <String>]
    -LiteralPath <String[]>
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-PassThru]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [<CommonParameters>]

L’applet de commande Move-Item déplace un élément, y compris ses propriétés, son contenu et ses éléments enfants, d’un emplacement à un autre emplacement. Les emplacements doivent être pris en charge par le même fournisseur. Par exemple, il peut déplacer un fichier ou un sous-répertoire d’un répertoire vers un autre ou déplacer une sous-clé de Registre d’une clé vers une autre. Lorsque vous déplacez un élément, il est ajouté au nouvel emplacement et supprimé de son emplacement d’origine.

Cette commande déplace le fichier «Test.txt» du lecteur C: vers le répertoire « E :\Temp » et le renomme de «test.txt» en «tst.txt».

Move-Item -Path C:\test.txt -Destination E:\Temp\tst.txt

Cette commande déplace le répertoire « C :\Temp » et son contenu vers le répertoire « C :\Logs ». Le répertoire « Temp », ainsi que tous ses sous-répertoires et fichiers, s’affichent ensuite dans le répertoire « Journaux ».

Move-Item -Path C:\Temp -Destination C:\Logs

Cette commande déplace tous les fichiers texte (« *.txt») dans le répertoire actif (représenté par un point ('.')) dans le répertoire « C :\Logs ».

Move-Item -Path .\*.txt -Destination C:\Logs

Cette commande déplace tous les fichiers texte du répertoire actif et de tous les sous-répertoires, récursivement, vers le répertoire « C :\TextFiles ».

La commande utilise l’applet de commande Get-ChildItem pour obtenir tous les éléments enfants du répertoire actif (représentés par le point [.]) et ses sous-répertoires qui ont une extension de nom de fichier «.txt». Il utilise le paramètre Recurse pour rendre la récupération récursive et le paramètre Include pour limiter la récupération aux fichiers «.txt».

L’opérateur de pipeline (|) envoie les résultats de cette commande à Move-Item, ce qui déplace les fichiers texte vers le répertoire « TextFiles ».

Si les fichiers à déplacer vers « C :\Textfiles » portent le même nom, Move-Item affiche une erreur et continue, mais il ne déplace qu’un seul fichier portant chaque nom sur « C :\Textfiles ». Les autres fichiers restent dans leurs répertoires d’origine.

Si le répertoire « Textfiles » (ou tout autre élément du chemin de destination) n’existe pas, la commande échoue. Le répertoire manquant n’est pas créé pour vous, même si vous utilisez le paramètre force . Move-Item déplace le premier élément vers un fichier appelé « Textfiles », puis affiche une erreur expliquant que le fichier existe déjà.

Par défaut, Get-ChildItem ne déplace pas les fichiers masqués. Pour déplacer des fichiers masqués, utilisez le paramètre force avec .

Remarque : Dans Windows PowerShell 2.0, lors de l’utilisation du paramètre Recurse de l’applet de commande , la valeur du paramètre path doit être un conteneur. Utilisez le paramètre Include pour spécifier le filtre d’extension de nom de fichier .txt (Get-ChildItem -Path .\* -Include *.txt -Recurse | Move-Item -Destination C:\TextFiles).

Get-ChildItem -Path ".\*.txt" -Recurse | Move-Item -Destination "C:\TextFiles"

Cette commande déplace les clés et valeurs de Registre dans la clé de Registre « MyCompany » dans « HKLM\Software » vers la clé « MyNewCompany ». Le caractère générique ('*') indique que le contenu de la clé « MyCompany » doit être déplacé, et non pas la clé elle-même. Dans cette commande, le chemin d’accès facultatif et noms de paramètres de destination sont omis.

Move-Item "HKLM:\software\mycompany\*" "HKLM:\software\mynewcompany"

Cette commande déplace le répertoire « Logs[Sept'06] » (et son contenu) dans le répertoire « Logs[2006] ».

Le paramètre LiteralPath est utilisé au lieu de Chemin d’accès, car le nom du répertoire d’origine inclut les crochets gauche et les crochets droit (« [ » et « ] »). Le chemin est également placé entre guillemets simples (' '), de sorte que le symbole backtick (') n’est pas mal interprété.

Le paramètre Destination ne nécessite pas de chemin littéral, car la variable de destination doit également être placée entre guillemets simples, car elle inclut des crochets qui peuvent être mal interprétés.

Move-Item -LiteralPath 'Logs[Sept`06]' -Destination 'Logs[2006]'

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.

Vous pouvez acheminer une chaîne contenant un chemin vers cette applet de commande.

Lorsque vous utilisez le paramètre passThru , cette applet de commande génère un objet représentant l’élément déplacé. Sinon, cette applet de commande ne génère aucune sortie.

Cette applet de commande déplace les fichiers entre les lecteurs pris en charge par le même fournisseur, mais il déplace les répertoires uniquement dans le même lecteur.

Étant donné qu’une commande Move-Item déplace les propriétés, le contenu et les éléments enfants d’un élément, tous les déplacements sont récursifs par défaut.

Cette applet de commande est conçue 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.