Copia un elemento da un percorso a un altro all'interno di uno spazio dei nomi.

Sintassi

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

Descrizione

Il cmdlet Copy-Item copia un elemento da un percorso a un altro in uno spazio dei nomi. Copy-Item non elimina gli elementi copiati. Gli elementi che è possibile copiare tramite il cmdlet dipendono dai provider di Windows PowerShell disponibili. Quando viene utilizzato con il provider FileSystem, ad esempio, il cmdlet può copiare file e directory, mentre quando viene utilizzato con il provider Registry può copiare chiavi e voci del Registro di sistema.

Parametri

-Container

Mantiene gli oggetti contenitore durante l'operazione di copia.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Credential <PSCredential>

Specifica un account utente con autorizzazione per l'esecuzione di questa azione. Il valore predefinito è l'utente corrente.

Digitare un nome utente, ad esempio "Utente01" o "Dominio01\Utente01", o immettere un oggetto PSCredential, ad esempio uno generato dal cmdlet Get-Credential. Se si digita un nome utente, viene richiesta una password.

Questo parametro non è supportato dai provider installati con Windows PowerShell.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

true (ByPropertyName)

Accettare caratteri jolly?

false

-Destination <string>

Specifica il percorso in cui gli elementi devono essere copiati.

Obbligatorio?

false

Posizione?

2

Valore predefinito

Accettare input da pipeline?

true (ByPropertyName)

Accettare caratteri jolly?

false

-Exclude <string[]>

Omette gli elementi specificati. È consentito l'utilizzo di caratteri jolly.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Filter <string>

Specifica un filtro nel formato o nel linguaggio del provider. Il valore di questo parametro qualifica il parametro Path. La sintassi del filtro, incluso l'utilizzo dei caratteri jolly, dipende dal provider. I filtri sono più efficienti rispetto ad altri parametri, perché il provider li applica al momento del recupero degli oggetti, anziché utilizzare Windows PowerShell per filtrare gli oggetti dopo il recupero.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Force

Consente al cmdlet di copiare elementi che non possono essere modificati in altro modo, ad esempio eseguire una copia su un file o un alias di sola lettura.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Include <string[]>

Specifica solo gli elementi sui quali il cmdlet può eseguire operazioni, escludendo tutti gli altri.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-LiteralPath <string[]>

Specifica un percorso dell'elemento. Il valore del parametro LiteralPath viene utilizzato esattamente come viene digitato. Nessun carattere viene interpretato come carattere jolly. Se il percorso include caratteri di escape, è necessario racchiuderli tra virgolette singole tramite le quali si comunica a Windows PowerShell di non interpretare alcun carattere come sequenza di escape.

Obbligatorio?

true

Posizione?

1

Valore predefinito

Accettare input da pipeline?

true (ByPropertyName)

Accettare caratteri jolly?

false

-PassThru

Restituisce un oggetto che rappresenta ogni elemento copiato. Per impostazione predefinita, il cmdlet non genera alcun output.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Path <string[]>

Specifica il percorso degli elementi da copiare.

Obbligatorio?

true

Posizione?

1

Valore predefinito

Accettare input da pipeline?

true (ByValue, ByPropertyName)

Accettare caratteri jolly?

false

-Recurse

Specifica una copia ricorsiva.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-Confirm

Chiede una conferma prima di eseguire il comando.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-WhatIf

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

-UseTransaction

Include il comando nella transazione attiva. Questo parametro è valido solo quando è in corso una transazione. Per ulteriori informazioni, vedere about_Transactions.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

<CommonParameters>

Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.

Input e output

Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.

Input

System.String

È possibile reindirizzare una stringa che contiene un percorso a Copy-ItemProperty.

Output

Nessuno o un oggetto che rappresenta l'elemento copiato.

Quando si utilizza il parametro PassThru, Copy-Item restituisce un oggetto che rappresenta l'elemento copiato. Negli altri casi, il cmdlet non genera alcun output.

Note

Copy-Item è simile al comando 'cp' o 'copy' in altre shell.

Il cmdlet Copy-Item è progettato per l'utilizzo di dati esposti da qualsiasi provider. Per elencare i provider disponibili nella sessione, digitare "Get-PsProvider". Per ulteriori informazioni, vedere about_Providers.

Esempio 1

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

Descrizione
-----------
Con questo comando il file mar1604.log.txt viene copiato nella directory C:\Presentation. Il file originale non viene eliminato.






Esempio 2

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

Descrizione
-----------
Con questo comando l'intero contenuto della directory Logfiles viene copiato nella directory Drawings. Se la directory di origine contiene file nelle relative sottodirectory, queste vengono copiate mantenendo intatti gli alberi dei file. Per impostazione predefinita, il parametro Container è impostato su true. In questo modo, la struttura della directory viene mantenuta.






Esempio 3

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

Descrizione
-----------
Con questo comando il contenuto della directory C:\Logfiles viene copiato nella directory C:\Drawings\Logs. Se non esiste, la sottodirectory \Logs verrà creata automaticamente.






Vedere anche




Argomenti della Guida