Copy-Item

Module:: Microsoft.PowerShell.Management Module

Copie un élément d’un emplacement vers un autre.

Syntaxe

Path (Par défaut)

Copy-Item
    [-Path] <String[]>
    [[-Destination] <String>]
    [-Container]
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Recurse]
    [-PassThru]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [-FromSession <PSSession>]
    [-ToSession <PSSession>]
    [<CommonParameters>]

LiteralPath

Copy-Item
    [[-Destination] <String>]
    -LiteralPath <String[]>
    [-Container]
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Recurse]
    [-PassThru]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [-UseTransaction]
    [-FromSession <PSSession>]
    [-ToSession <PSSession>]
    [<CommonParameters>]

Description

L’applet de commande Copy-Item copie un élément d’un emplacement vers un autre emplacement dans le même espace de noms. Par exemple, il peut copier un fichier dans un dossier, mais il ne peut pas copier un fichier dans un lecteur de certificat.

Cette applet de commande ne coupe pas ou ne supprime pas les éléments copiés. Les éléments particuliers que l’applet de commande peut copier dépendent du fournisseur PowerShell qui expose l’élément. Par exemple, il peut copier des fichiers et des répertoires dans un lecteur de système de fichiers et des clés de Registre et des entrées dans le lecteur de Registre.

Cette applet de commande peut copier et renommer des éléments dans la même commande. Pour renommer un élément, entrez le nouveau nom dans la valeur du paramètre destination . Pour renommer un élément et ne pas le copier, utilisez l’applet de commande Rename-Item.

Exemples

Exemple 1 : Copier un fichier dans le répertoire spécifié

Cet exemple copie le fichier mar1604.log.txt dans le répertoire C:\Presentation. Le fichier d’origine n’est pas supprimé.

Copy-Item "C:\Wabash\Logfiles\mar1604.log.txt" -Destination "C:\Presentation"

Exemple 2 : Copier le contenu du répertoire dans un répertoire existant

Cet exemple copie le contenu du répertoire C:\Logfiles dans le répertoire C:\Drawings existant. Le répertoire Logfiles n’est pas copié.

Si le répertoire Logfiles contient des fichiers dans des sous-répertoires, ces sous-répertoires sont copiés avec leurs arborescences de fichiers intactes. Par défaut, le paramètre conteneur est défini sur True, qui conserve la structure du répertoire.

Copy-Item -Path "C:\Logfiles\*" -Destination "C:\Drawings" -Recurse

Remarque

Si vous devez inclure le répertoire Logfiles dans la copie, supprimez la \* du chemin d’accès . Par exemple:

Copy-Item -Path "C:\Logfiles" -Destination "C:\Drawings" -Recurse

Exemple 3 : Copier le contenu du répertoire dans un nouveau répertoire

Cet exemple copie le contenu du répertoire source C:\Logfiles et crée un répertoire de destination. Le nouveau répertoire de destination, \Logs est créé dans C:\Drawings.

Pour inclure le nom du répertoire source, copiez-le dans un répertoire de destination existant, comme indiqué dans Exemple 2. Ou nommez le nouveau répertoire de destination avec le même répertoire que le répertoire source.

Copy-Item -Path "C:\Logfiles" -Destination "C:\Drawings\Logs" -Recurse

Remarque

Si le chemin d’accès inclut \*, tout le contenu du répertoire, sans les arborescences de sous-répertoires, est copié dans le nouveau répertoire de destination. Par exemple:

Copy-Item -Path "C:\Logfiles\*" -Destination "C:\Drawings\Logs" -Recurse

Exemple 4 : Copier un fichier dans le répertoire spécifié et renommer le fichier

Cet exemple utilise l’applet de commande Copy-Item pour copier le script Get-Widget.ps1 du répertoire \\Server01\Share vers le répertoire \\Server12\ScriptArchive. Dans le cadre de l’opération de copie, la commande modifie le nom de l’élément de Get-Widget.ps1 en Get-Widget.ps1.txt, afin qu’elle puisse être attachée aux messages électroniques.

Copy-Item "\\Server01\Share\Get-Widget.ps1" -Destination "\\Server12\ScriptArchive\Get-Widget.ps1.txt"