Copy-Item

Copia un elemento de una ubicación a otra en un espacio de nombres.

Sintaxis

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

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

Descripción

El cmdlet Copy-Item cmdlet copia un elemento de una ubicación en otra de un espacio de nombres. Copy-Item no elimina los elementos copiados. Los elementos concretos que el cmdlet puede copiar dependen de los proveedores de Windows PowerShell disponibles. Por ejemplo, cuando se usa con el proveedor FileSystem puede copiar archivos y directorios, y cuando se usa con el proveedor Registry puede copiar claves y entradas del Registro.

Parámetros

-Container

Mantiene los objetos del contenedor durante la operación de copia.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Credential <PSCredential>

Especifica una cuenta de usuario con permiso para realizar esta acción. El valor predeterminado es el usuario actual.

Escriba un nombre de usuario, como "Usuario01" o "Dominio01\Usuario01", o bien, escriba un objeto PSCredential, como uno generado por el cmdlet Get-Credential. Si escribe un nombre de usuario se le pedirá una contraseña.

Este parámetro no es compatible con los proveedores que se instalan con Windows PowerShell.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	true (ByPropertyName)
¿Aceptar caracteres comodín?	false

-Destination <string>

Especifica la ruta de acceso a la ubicación en que se van a copiar los elementos.

¿Requerido?	false
¿Posición?	2
Valor predeterminado
¿Aceptar canalización?	true (ByPropertyName)
¿Aceptar caracteres comodín?	false

-Exclude <string[]>

Omite los elementos especificados. Se permite el uso de caracteres comodín.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Filter <string>

Especifica un filtro en el formato o lenguaje del proveedor. El valor de este parámetro califica el parámetro Path. La sintaxis del filtro, incluido el uso de caracteres comodín, depende del proveedor. Los filtros son más eficaces que otros parámetros, ya que el proveedor los aplica al recuperar los objetos en lugar de hacer que Windows PowerShell filtre los objetos después de recuperarlos.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Force

Permite al cmdlet copiar elementos que no se pueden cambiar de ningún otro modo, como copiar sobre un alias o un archivo de solo lectura.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Include <string[]>

Especifica únicamente aquellos elementos sobre los que actuará el cmdlet, y excluye a todos los demás.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-LiteralPath <string[]>

Especifica una ruta de acceso al elemento. El valor del parámetro LiteralPath se usa exactamente como se escribe. Ningún carácter se interpretará como un carácter comodín. Si la ruta incluye caracteres de escape, escríbala entre comillas simples. Las comillas simples indican a Windows PowerShell que no debe interpretar los caracteres como secuencias de escape.

¿Requerido?	true
¿Posición?	1
Valor predeterminado
¿Aceptar canalización?	true (ByPropertyName)
¿Aceptar caracteres comodín?	false

-PassThru

Devuelve un objeto que representa cada elemento copiado. De forma predeterminada, este cmdlet no genera resultados.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Path <string[]>

Especifica la ruta de acceso a los elementos que se van a copiar.

¿Requerido?	true
¿Posición?	1
Valor predeterminado
¿Aceptar canalización?	true (ByValue, ByPropertyName)
¿Aceptar caracteres comodín?	false

-Recurse

Especifica una copia recursiva.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Confirm

Solicita confirmación antes de ejecutar el comando.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-WhatIf

Describe lo que ocurriría si ejecutara el comando sin ejecutarlo realmente.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-UseTransaction

Incluye el comando en la transacción activa. Este parámetro sólo es válido cuando hay una transacción en curso. Para obtener más información, vea about_Transactions.

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.

Entradas y salidas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.

Entradas	System.String Puede canalizar una cadena que contiene una ruta de acceso a Copy-ItemProperty.
Salidas	Ninguno o un objeto que representa el elemento copiado. Cuando se usa el parámetro PassThru, Copy-Item devuelve un objeto que representa el elemento copiado. En caso contrario, este cmdlet no genera resultados.

Notas

Copy-Item es como los comandos 'cp' o 'copy' de otros shells.

El cmdlet Copy-Item está diseñado para funcionar con los datos expuestos por cualquier proveedor. Para mostrar los proveedores que están disponibles en la sesión, escriba "Get-PsProvider". Para obtener más información, vea about_Providers.

Ejemplo 1

C:\PS>copy-item C:\Wabash\Logfiles\mar1604.log.txt -destination C:\Presentation

Descripción
-----------
Este comando copiará el archivo mar1604.log.txt al directorio C:\Presentation. El comando no elimina el archivo original.

Ejemplo 2

C:\PS>copy-item C:\Logfiles -destination C:\Drawings -recurse

Descripción
-----------
Este comando copia todo el contenido del directorio Logfiles en el directorio Drawings. Si el directorio de origen contiene archivos en subdirectorios, esos subdirectorios se copiarán con sus árboles de archivos intactos. El parámetro Container se establece en true de forma predeterminada. Esto mantiene la estructura de directorios.

Ejemplo 3

C:\PS>copy-item C:\Logfiles -destination C:\Drawings\Logs -recurse

Descripción
-----------
Este comando copia todo el contenido del directorio C:\Logfiles al directorio C:\Drawings\Logs. Creará el subdirectorio \Logs si no existe aún.

Vea también

Conceptos

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