Copy-Item

Módulo:: Microsoft.PowerShell.Management Module

Copia um item de um local para outro.

Sintaxe

Path (Predefinição)

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

Description

O cmdlet Copy-Item copia um item de um local para outro no mesmo namespace. Por exemplo, ele pode copiar um arquivo para uma pasta, mas não pode copiar um arquivo para uma unidade de certificado.

Este cmdlet não corta nem exclui os itens que estão sendo copiados. Os itens específicos que o cmdlet pode copiar dependem do provedor do PowerShell que expõe o item. Por exemplo, ele pode copiar arquivos e diretórios em uma unidade do sistema de arquivos e chaves de registro e entradas na unidade de registro.

Este cmdlet pode copiar e renomear itens no mesmo comando. Para renomear um item, insira o novo nome no valor do parâmetro Destination. Para renomear um item e não copiá-lo, use o cmdlet Rename-Item.

Exemplos

Exemplo 1: Copiar um arquivo para o diretório especificado

Este exemplo copia o arquivo mar1604.log.txt para o diretório C:\Presentation. O ficheiro original não é eliminado.

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

Exemplo 2: Copiar o conteúdo do diretório para um diretório existente

Este exemplo copia o conteúdo do diretório C:\Logfiles para o diretório C:\Drawings existente. O diretório Logfiles não é copiado.

Se o diretório Logfiles contiver arquivos em subdiretórios, esses subdiretórios serão copiados com suas árvores de arquivos intactas. Por padrão, o parâmetro Container é definido como True, que preserva a estrutura de diretórios.

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

Observação

Se você precisar incluir o diretório Logfiles na cópia, remova o \* do Path. Por exemplo:

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

Exemplo 3: Copiar o conteúdo do diretório para um novo diretório

Este exemplo copia o conteúdo do diretório de origem C:\Logfiles e cria um novo diretório de destino. O novo diretório de destino, \Logs é criado em C:\Drawings.

Para incluir o nome do diretório de origem, copie para um diretório de destino existente, conforme mostrado no Exemplo 2. Ou, nomeie o novo diretório de destino com o mesmo que o diretório de origem.

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

Observação

Se o Caminho do incluir , todo o conteúdo do arquivo do diretório, sem as árvores de subdiretório, será copiado para o novo diretório de destino. Por exemplo:

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

Exemplo 4: Copiar um arquivo para o diretório especificado e renomear o arquivo

Este exemplo usa o cmdlet Copy-Item para copiar o script Get-Widget.ps1 do diretório \\Server01\Share para o diretório \\Server12\ScriptArchive. Como parte da operação de cópia, o comando altera o nome do item de Get-Widget.ps1 para Get-Widget.ps1.txt, para que possa ser anexado a mensagens de email.

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