Copy-Item

Riferimento

Modulo:: Microsoft.PowerShell.Management

Copia un elemento da una posizione a un'altra.

Sintassi

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

Descrizione

Il Copy-Item cmdlet 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 Rename-Item cmdlet .

Esempio

Esempio 1: Copiare un file nella directory specificata

In questo esempio il file viene mar1604.log.txt copiato nella C:\Presentation directory . 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 C:\Logfiles directory viene copiato nella directory esistente C:\Drawings . La Logfiles directory non viene copiata.

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

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

Nota

Se il percorso C:\Drawings non esiste, il cmdlet copia tutti i file dalla Logfiles cartella in un singolo file C:\Drawings.

Esempio 3: Copiare directory e contenuto in una nuova directory

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

Per includere il nome della directory di origine, copiare in una directory di destinazione esistente, come illustrato nell'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

Nota

Se il percorso include \*, tutti i contenuti del file della directory, inclusi gli alberi delle sottodirectory, vengono copiati nella nuova directory di destinazione. Ad 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 Copy-Item cmdlet per copiare lo Get-Widget.ps1 script dalla \\Server01\Share directory alla \\Server12\ScriptArchive directory . 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.

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