Copy-Item

Módulo:: Microsoft.PowerShell.Management Module

Copia un elemento de una ubicación a otra.

Sintaxis

Path (Default) - FileSystem provider

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>]

LiteralPath - FileSystem provider

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

Path (Default) - All providers

Copy-Item
    [-Path] <string[]>
    [[-Destination] <string>]
    [-Container]
    [-Force]
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Recurse]
    [-PassThru]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

LiteralPath - All providers

Copy-Item
    [[-Destination] <string>]
    -LiteralPath <string[]>
    [-Container]
    [-Force]
    [-Filter <string>]
    [-Include <string[]>]
    [-Exclude <string[]>]
    [-Recurse]
    [-PassThru]
    [-Credential <pscredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

El cmdlet Copy-Item copia un elemento de una ubicación a otra en el mismo espacio de nombres. Por ejemplo, puede copiar un archivo en una carpeta, pero no puede copiar un archivo en una unidad de certificado.

Este cmdlet no corta ni elimina los elementos que se copian. Los elementos concretos que el cmdlet puede copiar dependen del proveedor de PowerShell que expone el elemento. Por ejemplo, puede copiar archivos y directorios en una unidad del sistema de archivos y claves del Registro y entradas en la unidad del Registro.

Este cmdlet puede copiar y cambiar el nombre de los elementos en el mismo comando. Para cambiar el nombre de un elemento, escriba el nuevo nombre en el valor del parámetro destination de . Para cambiar el nombre de un elemento y no copiarlo, use el cmdlet Rename-Item.

Ejemplos

Ejemplo 1: Copiar un archivo en el directorio especificado

En este ejemplo se copia el archivo mar1604.log.txt en el directorio C:\Presentation. El archivo original no se elimina.

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

Ejemplo 2: Copia del contenido del directorio en un directorio existente

En este ejemplo se copia el contenido del directorio C:\Logfiles en el directorio C:\Drawings existente. El directorio Logfiles no se copia.

Si el directorio Logfiles tiene archivos en subdirectorios, esos subdirectorios se copian con sus árboles de archivos intactos. De forma predeterminada, el parámetro Container se establece en True, que conserva la estructura del directorio.

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

Nota:

Si la ruta de acceso C:\Drawings no existe, el cmdlet copia todos los archivos del árbol de carpetas de Logfiles en una sola carpeta C:\Drawings, sobrescribiendo los archivos con el mismo nombre.

Ejemplo 3: Copiar directorio y contenido en un nuevo directorio

En este ejemplo se copia el contenido del directorio de origen de C:\Logfiles y se crea un nuevo directorio de destino. El nuevo directorio de destino, \Logs se crea en C:\Drawings.

Para incluir el nombre del directorio de origen, copie en un directorio de destino existente como se muestra en ejemplo 2. O bien, asigne un nombre al nuevo directorio de destino con el mismo que el directorio de origen.

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

Nota:

Si la ruta de acceso incluye \*, todo el contenido del archivo del directorio, incluidos los árboles de subdirectorios, se copian en el nuevo directorio de destino. Por ejemplo:

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

Ejemplo 4: Copiar un archivo en el directorio especificado y cambiar el nombre del archivo

En este ejemplo se usa el cmdlet Copy-Item para copiar el script de Get-Widget.ps1 desde el directorio \\Server01\Share al directorio \\Server12\ScriptArchive. Como parte de la operación de copia, el comando cambia el nombre del elemento de Get-Widget.ps1 a Get-Widget.ps1.txt, por lo que se puede adjuntar de forma segura a los mensajes de correo electrónico.

$copyParams = @{
    Path        = "\\Server01\Share\Get-Widget.ps1"
    Destination = "\\Server12\ScriptArchive\Get-Widget.ps1.txt"
}
Copy-Item @copyParams