Copy-Item

Módulo:: Microsoft.PowerShell.Management Module

Copia um item de um local para outro.

Sintaxe

Path (Default)

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 local 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.

Esse 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 e entradas do Registro na unidade do Registro.

Esse 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 arquivo original não é excluído.

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

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

Este exemplo copia o conteúdo do diretório C:\Logfiles no 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 do diretório.

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

Observação

Se você precisar incluir o diretório na cópia, remova o dode Caminho . Por exemplo:

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

Exemplo 3: Copiar 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 em Exemplo 2. Ou nomeie o novo diretório de destino com o mesmo diretório de origem.

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

Observação

Se o Path 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 ele possa ser anexado a mensagens de email.

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