Copy-Item
Copia um item de um local para outro dentro de um namespace.
Sintaxe
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>]
Descrição
O cmdlet Copy-Item copia um item de um local para outro em um namespace. Copy-Item não exclui os itens que estão sendo copiados. Os itens específicos que o cmdlet pode copiar dependem de quais provedores do Windows PowerShell estão disponíveis. Por exemplo, quando utilizado com o provedor FileSystem, ele pode copiar arquivos e diretórios e quando usado com o provedor Registry, pode copiar chaves e entradas do Registro.
Parâmetros
-Container
Guarda objetos de contêiner durante a operação de cópia.
| Necessário? | false |
| Posição? | named |
| Valor padrão | |
| Aceitar entrada do pipeline? | false |
| Aceitar caracteres curinga? | false |
-Credential <PSCredential>
Especifica uma conta de usuário com permissão para executar essa ação. O padrão é o usuário atual.
Digite um nome de usuário, como "User01" ou "Domain01\User01", ou insira um objeto PSCredential, como aquele gerado pelo cmdlet Get-Credential. Uma senha será solicitada após a digitação do nome do usuário.
Este parâmetro não tem suporte em nenhum dos provedores instalados com o Windows PowerShell.
| Necessário? | false |
| Posição? | named |
| Valor padrão | |
| Aceitar entrada do pipeline? | true (ByPropertyName) |
| Aceitar caracteres curinga? | false |
-Destination <string>
Especifica o caminho para o local onde estão os itens a serem copiados.
| Necessário? | false |
| Posição? | 2 |
| Valor padrão | |
| Aceitar entrada do pipeline? | true (ByPropertyName) |
| Aceitar caracteres curinga? | false |
-Exclude <string[]>
Omite os itens especificados. Os caracteres curinga são permitidos.
| Necessário? | false |
| Posição? | named |
| Valor padrão | |
| Aceitar entrada do pipeline? | false |
| Aceitar caracteres curinga? | false |
-Filter <string>
Especifica um filtro no formato ou no idioma do provedor. O valor desse parâmetro qualifica o parâmetro Path. A sintaxe do filtro, incluindo o uso dos caracteres curinga, depende do provedor. Os filtros são mais eficientes do que outros parâmetros porque o provedor os aplica durante a recuperação dos objetos, em vez de fazer com que o Windows PowerShell os filtre depois de recuperados.
| Necessário? | false |
| Posição? | named |
| Valor padrão | |
| Aceitar entrada do pipeline? | false |
| Aceitar caracteres curinga? | false |
-Force
Permite que o cmdlet copie os itens que não podem ser alterados, como aliases ou arquivos somente leitura.
| Necessário? | false |
| Posição? | named |
| Valor padrão | |
| Aceitar entrada do pipeline? | false |
| Aceitar caracteres curinga? | false |
-Include <string[]>
Especifica somente os itens em que o cmdlet agirá, excluindo todos os outros.
| Necessário? | false |
| Posição? | named |
| Valor padrão | |
| Aceitar entrada do pipeline? | false |
| Aceitar caracteres curinga? | false |
-LiteralPath <string[]>
Especifica o caminho para o item. O valor do parâmetro LiteralPath é usado exatamente como digitado. Nenhum caractere será interpretado como curinga. Se o caminho incluir caracteres de escape, coloque-os entre aspas simples. As aspas simples dizem ao Windows PowerShell para não interpretar quaisquer caracteres que tenham sequências de escape.
| Necessário? | true |
| Posição? | 1 |
| Valor padrão | |
| Aceitar entrada do pipeline? | true (ByPropertyName) |
| Aceitar caracteres curinga? | false |
-PassThru
Retorna um objeto que representa cada item copiado. Por padrão, este cmdlet não gera nenhuma saída.
| Necessário? | false |
| Posição? | named |
| Valor padrão | |
| Aceitar entrada do pipeline? | false |
| Aceitar caracteres curinga? | false |
-Path <string[]>
Especifica o caminho para os itens a serem copiados.
| Necessário? | true |
| Posição? | 1 |
| Valor padrão | |
| Aceitar entrada do pipeline? | true (ByValue, ByPropertyName) |
| Aceitar caracteres curinga? | false |
-Recurse
Especifica uma cópia recursiva.
| Necessário? | false |
| Posição? | named |
| Valor padrão | |
| Aceitar entrada do pipeline? | false |
| Aceitar caracteres curinga? | false |
-Confirm
Solicita confirmação antes da execução do comando.
| Necessário? | false |
| Posição? | named |
| Valor padrão | |
| Aceitar entrada do pipeline? | false |
| Aceitar caracteres curinga? | false |
-WhatIf
Descreve o que aconteceria se você executasse o comando, sem executá-lo de fato.
| Necessário? | false |
| Posição? | named |
| Valor padrão | |
| Aceitar entrada do pipeline? | false |
| Aceitar caracteres curinga? | false |
-UseTransaction
Inclui o comando na transação ativa. Este parâmetro é válido apenas quando uma transação está em andamento. Para obter mais informações, consulte about_Transactions.
| Necessário? | false |
| Posição? | named |
| Valor padrão | |
| Aceitar entrada do pipeline? | false |
| Aceitar caracteres curinga? | false |
<CommonParameters>
Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.
Entradas e saídas
O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.
| Entradas | System.String
Você pode enviar uma string que contém um caminho para Copy-ItemProperty. |
| Saídas | None ou um objeto que representa o item copiado.
Quando você usar o parâmetro PassThru, Copy-Item retornará um objeto que representa o item copiado. Caso contrário, esse cmdlet não gera nenhuma saída. |
Observações
Copy-Item é semelhante aos comandos 'cp' ou 'copy' de outros shells.
O cmdlet Copy-Item foi desenvolvido para funcionar com os dados expostos por qualquer provedor. Para listar os provedores disponíveis em sua sessão, digite "Get-PsProvider". Para obter mais informações, consulte about_Providers.
Exemplo 1
C:\PS>copy-item C:\Wabash\Logfiles\mar1604.log.txt -destination C:\Presentation Descrição ----------- Esse comando copiará o arquivo mar1604.log.txt para o diretório C:\Presentation. Ele não exclui o arquivo original.
Exemplo 2
C:\PS>copy-item C:\Logfiles -destination C:\Drawings -recurse Descrição ----------- Esse comando copia todo o conteúdo do diretório Logfiles para o diretório Drawings. Caso o diretório de origem contenha arquivos nos subdiretórios, esses subdiretórios serão copiados com suas árvores de arquivos intactas. Por padrão, o parâmetro Container é definido como true. Isso faz com que a estrutura do diretório seja preservada.
Exemplo 3
C:\PS>copy-item C:\Logfiles -destination C:\Drawings\Logs -recurse Descrição ----------- Esse comando copia todo o conteúdo do diretório C:\Logfiles para o diretório C:\Drawings\Logs. Ele criará o subdiretório \Logs caso ele ainda não exista.