Copy-Item

Referencia

Módulo:: Microsoft.PowerShell.Management

Copia un elemento de una ubicación a otra.

Sintaxis

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

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

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

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

Description

El Copy-Item cmdlet 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 . Para cambiar el nombre de un elemento y no copiarlo, use el Rename-Item cmdlet .

Ejemplos

Ejemplo 1: Copiar un archivo en el directorio especificado

En este ejemplo se copia el mar1604.log.txt archivo en el C:\Presentation directorio . 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 C:\Logfiles directorio en el directorio existente C:\Drawings . El Logfiles directorio no se copia.

Si el Logfiles directorio 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 Logfiles árbol de carpetas 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 C:\Logfiles directorio de origen y se crea un nuevo directorio de destino. El nuevo directorio de destino se \Logs crea en C:\Drawings.

Para incluir el nombre del directorio de origen, copie en un directorio de destino existente como se muestra en el 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 Copy-Item cmdlet para copiar el Get-Widget.ps1 script desde el \\Server01\Share directorio al \\Server12\ScriptArchive directorio . 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.

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