Copy-Item

Modulo:: Microsoft.PowerShell.Management Module

Copia un elemento da una posizione a un'altra.

Sintassi

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

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 directory Logfiles contiene file nelle sottodirectory, tali sottodirectory vengono copiate con i relativi alberi dei 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 il percorso C:\Drawings non esiste, il cmdlet copia tutti i file dall'albero delle cartelle Logfiles in una singola cartella C:\Drawings, sovrascrivendo tutti i file con lo stesso nome.

Esempio 3: Copiare directory e contenuto 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 \*, tutti i contenuti del file della directory, inclusi gli alberi delle sottodirectory, vengono copiati 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 collegato in modo sicuro ai messaggi di posta elettronica.

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