Copy-Item

Referência

Módulo:: Microsoft.PowerShell.Management

Copia um item de um local para outro.

Syntax

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

Description

O Copy-Item cmdlet 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 de registro e entradas 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 Rename-Item cmdlet.

Exemplos

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

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

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

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

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

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

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

Observação

Se o caminho C:\Drawings não existir, o cmdlet copiará todos os arquivos da Logfiles pasta em um único arquivo C:\Drawings.

Exemplo 3: copiar diretório e conteúdo 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 \Logs destino é 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 diretório de origem.

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

Observação

Se o Caminho incluir \*, todo o conteúdo do arquivo do diretório, incluindo as árvores subdiretórias, 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 Copy-Item cmdlet para copiar o Get-Widget.ps1 script do \\Server01\Share diretório para o \\Server12\ScriptArchive diretório. Como parte da operação de cópia, o comando altera o nome do item de Get-Widget.ps1 para Get-Widget.ps1.txt, portanto, ele pode ser anexado com segurança às mensagens de email.

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