Move-Item

Déplace un élément d'un emplacement à un autre.

Syntaxe

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

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

Description

L'applet de commande Move-Item déplace un élément, de même que ses propriétés, son contenu et ses éléments enfants, d'un emplacement vers un autre emplacement. Les emplacements doivent être pris en charge par le même fournisseur. Par exemple, elle peut déplacer un fichier ou un sous-répertoire d'un répertoire à un autre ou une sous-clé de Registre d'une clé à une autre. Lors du déplacement d'un élément, celui-ci est ajouté au nouvel emplacement et supprimé de l'emplacement d'origine.

Paramètres

-Credential <PSCredential>

Spécifie un compte d'utilisateur qui a l'autorisation d'exécuter cette action. La valeur par défaut est l'utilisateur actuel.

Tapez un nom d'utilisateur, tel que « User01 » ou « Domain01\User01 », ou entrez un objet PSCredential, tel que celui généré par l'applet de commande Get-Credential. Si vous tapez un nom d'utilisateur, vous êtes invité à entrer un mot de passe.

Ce paramètre n'est pas pris en charge par les fournisseurs installés avec Windows PowerShell.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	true (ByPropertyName)
Accepter les caractères génériques ?	false

-Destination <string>

Spécifie le chemin d'accès à l'emplacement vers lequel les éléments sont déplacés. L'emplacement par défaut est le répertoire actif. Les caractères génériques sont autorisés, mais le résultat doit spécifier un seul emplacement.

Pour renommer l'élément à déplacer, spécifiez un nouveau nom dans la valeur du paramètre Destination.

Obligatoire ?	false
Position ?	2
Valeur par défaut
Accepter l'entrée de pipeline ?	true (ByPropertyName)
Accepter les caractères génériques ?	false

-Exclude <string[]>

Omet les éléments spécifiés. La valeur de ce paramètre qualifie le paramètre Path. Entrez un élément ou un modèle de chemin d'accès, tel que « *.txt ». Les caractères génériques sont autorisés.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-Filter <string>

Spécifie un filtre dans le format ou le langage du fournisseur. La valeur de ce paramètre qualifie le paramètre Path. La syntaxe du filtre, notamment l'utilisation de caractères génériques, dépend du fournisseur. Les filtres sont plus efficaces que les autres paramètres, car le fournisseur les applique lors de la récupération des objets, plutôt que de laisser le soin à Windows PowerShell de filtrer les objets une fois qu'ils ont été récupérés.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-Force

Permet à l'applet de commande de déplacer un élément qui remplace un élément en lecture seule existant. L'implémentation est différente d'un fournisseur à l'autre. Pour plus d'informations, consultez about_Providers. Même en utilisant le paramètre Force, l'applet de commande ne peut pas remplacer les restrictions de sécurité.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-Include <string[]>

Déplace uniquement les éléments spécifiés. La valeur de ce paramètre qualifie le paramètre Path. Entrez un élément ou un modèle de chemin d'accès, tel que « *.txt ». Les caractères génériques sont autorisés.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-LiteralPath <string[]>

Spécifie le chemin d'accès à l'emplacement actuel des éléments. Contrairement à Path, la valeur de LiteralPath est utilisée exactement telle que vous la tapez. 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 à Windows PowerShell qu'aucun caractère ne doit être interprété en tant que séquence d'échappement.

Obligatoire ?	true
Position ?	1
Valeur par défaut
Accepter l'entrée de pipeline ?	true (ByPropertyName)
Accepter les caractères génériques ?	false

-PassThru

Passe un objet représentant l'élément au pipeline. Par défaut, cette applet de commande ne génère aucune sortie.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-Path <string[]>

Spécifie le chemin d'accès à l'emplacement actuel des éléments. L'emplacement par défaut est le répertoire actif. Les caractères génériques sont autorisés.

Obligatoire ?	true
Position ?	1
Valeur par défaut
Accepter l'entrée de pipeline ?	true (ByValue, ByPropertyName)
Accepter les caractères génériques ?	false

-Confirm

Vous invite à confirmer l'exécution de la commande.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-WhatIf

Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	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.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.

Entrées et sorties

Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.

Entrées	System.String Vous pouvez diriger une chaîne qui contient un chemin d'accès vers Move-Item.
Sorties	Aucun ou un objet représentant l'élément déplacé. Lorsque vous utilisez le paramètre PassThru, Move-Item génère un objet qui représente l'élément déplacé. Sinon, cette applet de commande ne génère aucune sortie.

Remarques

Move-Item déplace des fichiers entre des lecteurs qui sont pris en charge par un même fournisseur, mais elle déplace des répertoires uniquement à l'intérieur d'un même lecteur.

Dans la mesure où 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.

Vous pouvez également faire référence à Move-Item par ses alias intégrés,« move », « mv » et « mi ». Pour plus d'informations, consultez about_Aliases.

L'applet de commande Move-Item est conçue pour utiliser 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.

Exemple 1

C:\PS>move-item -path C:\test.txt -destination E:\Temp\tst.txt

Description
-----------
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 ».

Exemple 2

C:\PS>move-item -path C:\Temp -destination C:\Logs

Description
-----------
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, figurent alors dans le répertoire Logs.

Exemple 3

C:\PS>move-item -path .\*.txt -destination C:\Logs

Description
-----------
Cette commande déplace tous les fichiers texte (*.txt) du répertoire actif (représenté par un point (.)) vers le répertoire C:\Logs.

Exemple 4

C:\PS>get-childitem -path . -recurse -include *.txt | move-item -destination C:\TextFiles

Description
-----------
Cette commande déplace tous les fichiers texte du répertoire actif et de ses sous-répertoires, de manière récursive, 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é par le point [.]) et ses sous-répertoires dont le nom de fichier porte l'extension *.txt. Elle utilise le paramètre Recurse pour récupérer ces éléments de manière 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 qui déplace les fichiers texte vers le répertoire TextFiles.

Si des fichiers déplacés vers C:\Textfiles portent le même nom, Move-Item affiche un message d'erreur et poursuit l'opération, mais un seul fichier de chaque nom est déplacé vers C:\Textfiles. Les autres fichiers restent dans les 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 automatiquement créé, même si vous utilisez le paramètre Force. Move-Item déplace le premier élément vers un fichier appelé « Textfiles » et affiche ensuite un message d'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 Get-ChildItem.

Exemple 5

C:\PS>move-item hklm:\software\mycompany\* hklm:\software\mynewcompany

Description
-----------
Cette commande déplace les clés et les valeurs de Registre de la clé de Registre MyCompany figurant sous 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 la clé proprement dite. Dans cette commande, les noms de paramètres optionnels Path et Destination sont omis.

Exemple 6

C:\PS>move-item -literalpath 'Logs[Sept`06]' -destination 'Logs[2006]'

Description
-----------
Cette commande déplace le répertoire Logs[Sept`06] (et son contenu) vers le répertoire Logs[2006]. 

Le paramètre LiteralPath est utilisé à la place de Path, car le nom du répertoire d'origine inclut le crochet ouvrant et le crochet fermant (« [ » et « ] »). Le chemin d'accès est également placé entre des guillemets simples (' '), afin que le symbole de backtick (') ne soit pas incorrectement interprété. 

Le paramètre Destination ne requiert pas de chemin d'accès littéral. En effet, la variable Destination doit également être insérée entre des guillemets simples car elle inclut des crochets qui risquent d'être incorrectement interprétés.

Voir aussi

Concepts

about_Providers
Clear-Item
Get-Item
Invoke-Item
Set-Item
New-Item
Remove-Item
Rename-Item
Copy-Item