Copy-Item

Référence

Module:: Microsoft.PowerShell.Management

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

Syntax

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

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

Description

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

Cette applet de commande ne coupe ni ne supprime 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 instance, il peut copier des fichiers et des répertoires dans un lecteur de système de fichiers, ainsi que des clés et des entrées de Registre 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 Rename-Item commande .

Exemples

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

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

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

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

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

Si le Logfiles répertoire 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 Container est défini sur True, ce qui conserve la structure de répertoires.

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

Notes

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

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

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

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

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

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

Notes

Si le chemin d’accès inclut \*, tout le contenu du fichier du répertoire, y compris 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 Copy-Item de commande pour copier le Get-Widget.ps1 script du \\Server01\Share répertoire vers le \\Server12\ScriptArchive répertoire. Dans le cadre de l’opération de copie, la commande remplace le nom de l’élément par Get-Widget.ps1Get-Widget.ps1.txt, afin qu’il puisse être joint aux messages électroniques.

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