Copy-Item

Modulo:: Microsoft.PowerShell.Management Module

Copia un elemento da una posizione a un'altra.

Sintassi

Path (Impostazione predefinita)

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

Descrizione

Il cmdlet Copy-Item copia un elemento da una posizione a un'altra nello stesso spazio dei nomi. Ad esempio, può copiare un file in una cartella, ma non può copiare un file in un'unità certificato.

Questo cmdlet non taglia o elimina gli elementi copiati. Gli elementi specifici che il cmdlet può copiare dipendono dal provider di PowerShell che espone l'elemento. Ad esempio, può copiare file e directory in un'unità del file system e chiavi e voci del Registro di sistema nell'unità del Registro di sistema.

Questo cmdlet può copiare e rinominare gli elementi nello stesso comando. Per rinominare un elemento, immettere il nuovo nome nel valore del parametro Destination. Per rinominare un elemento e non copiarlo, usare il cmdlet Rename-Item.

Esempio

Esempio 1: Copiare un file nella directory specificata

In questo esempio il file mar1604.log.txt viene copiato nella directory C:\Presentation. Il file originale non viene eliminato.

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

Esempio 2: Copiare il contenuto della directory in una directory esistente

In questo esempio il contenuto della directory C:\Logfiles viene copiato nella directory C:\Drawings esistente. La directory Logfiles non viene copiata.

Se la Logfiles directory contiene file in sottodirectory, tali sottodirectory vengono copiate con i relativi alberi di file intatti. Per impostazione predefinita, il parametro contenitore è impostato su True, che mantiene la struttura di directory.

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

Annotazioni

Se è necessario includere la Logfiles directory nella copia, rimuoverla \* dal percorso. Per esempio:

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

Esempio 3: Copiare il contenuto della directory in una nuova directory

In questo esempio viene copiato il contenuto della directory di origine C:\Logfiles e viene creata una nuova directory di destinazione. La nuova directory di destinazione, \Logs viene creata in C:\Drawings.

Per includere il nome della directory di origine, copiare in una directory di destinazione esistente, come illustrato in esempio 2. In alternativa, assegnare alla nuova directory di destinazione lo stesso nome della directory di origine.

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

Annotazioni

Se il percorso include \*, tutto il contenuto dei file della directory, senza gli alberi delle sottodirectory, viene copiato nella nuova directory di destinazione. Per esempio:

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

Esempio 4: Copiare un file nella directory specificata e rinominare il file

In questo esempio viene usato il cmdlet Copy-Item per copiare lo script Get-Widget.ps1 dalla directory \\Server01\Share alla directory \\Server12\ScriptArchive. Come parte dell'operazione di copia, il comando modifica il nome dell'elemento da Get-Widget.ps1 a Get-Widget.ps1.txt, in modo che possa essere allegato ai messaggi di posta elettronica.

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