O comando xcopy é um comando do Prompt de Comando usado para copiar um ou mais arquivos ou pastas de um local para outro.
Com suas muitas opções e capacidade de copiar diretórios inteiros, é semelhante, mas muito mais poderoso que o comando copy. O comando robocopy também é semelhante, mas tem ainda mais opções.
Disponibilidade do comando Xcopy
Este comando está disponível no Prompt de Comando em todos os sistemas operacionais Windows, incluindo Windows 10, Windows 8, Windows 7, Windows Vista, Windows XP, Windows 98, etc.
Você também pode acessar o comando no MS-DOS como um comando DOS.
Sintaxe do Comando Xcopy
Use a seguinte sintaxe para o comando xcopy:
xcopy origem [destino] [ /a] [ /b] [/c ] [/d [: data] [/e ] [ /f ] [/g ] [/h ] [/i] [ /j] [ /k] [ /l] [ /m] [ /n] [ /o] [ /p] [ /q] [ /r] [ /s] [ /t] [ /u] [ /v] [ /w] [ /x] [ /y] [ /-y] [ /z] [/exclude: arquivo1 [+ arquivo2][+ arquivo3]…] [ /? ]
A disponibilidade de certas opções de comando xcopy e outras sintaxes de comando podem diferir de sistema operacional para sistema operacional. Aprenda a ler a sintaxe do comando se não tiver certeza de como ler a sintaxe acima ou na tabela abaixo.
| Opções do Comando Xcopy | |
|---|---|
| Item | Descrição |
| fonte | Isso define os arquivos ou a pasta de nível superior que você deseja copiar. A fonte é o único parâmetro obrigatório. Use aspas ao redor da fonte se ela contiver espaços. |
| destino | Esta opção especifica o local onde os arquivos ou pastas de origem devem ser copiados. Se nenhum destino estiver listado, os arquivos ou pastas serão copiados para a mesma pasta da qual você executa o comando xcopy. Use aspas ao redor do destino se ele contiver espaços. |
| /a | Usar esta opção só copiará arquivos compactados encontrados em source. Você não pode usar /a e /m juntos. |
| /b | Use esta opção para copiar o próprio link simbólico em vez do destino do link. Esta opção foi disponibilizada pela primeira vez no Windows Vista. |
| /c | Esta opção força o xcopy a continuar mesmo se encontrar um erro. |
| /d [ : data] | Use o comando com a opção /d e uma data específica, no formato MM-DD-AAAA, para copiar arquivos alterados a partir dessa data. Você também pode usar esta opção sem especificar uma data específica para copiar apenas os arquivos na origem que são mais recentes do que os mesmos arquivos que já existem no destino. Isso é útil ao usar o xcopy para realizar backups regulares de arquivos. |
| /e | Quando usado sozinho ou com /s, esta opção é a mesma que /s mas também criará pastas vazias no destino que também estavam vazios na fonte. A opção /e também pode ser usada junto com a opção /t para incluir diretórios e subdiretórios vazios encontrados em source na estrutura de diretórios criada em destination. |
| /f | Esta opção exibirá o caminho completo e o nome do arquivo dos arquivos de origem e destino que estão sendo copiados. |
| /g | Usar xcopy com esta opção permite copiar arquivos criptografados na origem para um destino que não suporta criptografia. Esta opção não funcionará ao copiar arquivos de uma unidade criptografada por EFS para uma unidade não criptografada por EFS. |
| /h | O comando não copia arquivos ocultos ou arquivos do sistema por padrão, mas o fará ao usar esta opção. |
| /i | Use a opção /i para forçar o xcopy a assumir que o destino é um diretório. Se você não usar essa opção e estiver copiando da origem que é um diretório ou grupo de arquivos e copiando para um destino que não existe, o comando xcopy solicitará que você digite se o destino é um arquivo ou diretório. |
| /j | Esta opção copia arquivos sem buffer, um recurso útil para arquivos muito grandes. Esta opção foi disponibilizada pela primeira vez no Windows 7. |
| /k | Use esta opção ao copiar arquivos somente leitura para manter esse atributo de arquivo no destino. |
| /l | Use esta opção para mostrar uma lista dos arquivos e pastas a serem copiados… mas nenhuma cópia é feita. A opção /l é útil se você estiver construindo um comando complicado com várias opções e gostaria de ver como ele funcionaria hipoteticamente. |
| /m | Esta opção é idêntica à opção /a mas xcopy irá desligar o atributo archive após copiar o arquivo. Você não pode usar /m e /a juntos. |
| /n | Esta opção cria arquivos e pastas no destino usando nomes de arquivo curtos. Esta opção só é útil quando você está usando o comando para copiar arquivos para um destino que existe em uma unidade formatada para um sistema de arquivos mais antigo, como FAT, que não suporta nomes de arquivos longos. |
| /o | Mantém a propriedade e as informações da Lista de Controle de Acesso (ACL) nos arquivos escritos no destino. |
| /p | Ao usar esta opção, você será avisado antes da criação de cada arquivo no destino. |
| /q | Uma espécie de oposto da opção /f, a opção /q colocará o xcopy no modo "silencioso", pulando o on -exibição na tela de cada arquivo sendo copiado. |
| /r | Use esta opção para sobrescrever arquivos somente leitura no destino. Se você não usar essa opção quando quiser sobrescrever um arquivo somente leitura em destination, será exibida uma mensagem "Acesso negado" e o comando será interrompido. |
| /s | Use esta opção para copiar diretórios, subdiretórios e os arquivos contidos neles, além dos arquivos na raiz de source. Pastas vazias não serão recriadas. |
| /t | Esta opção força o comando xcopy a criar uma estrutura de diretórios no destino, mas não a copiar nenhum dos arquivos. Em outras palavras, as pastas e subpastas encontradas no código-fonte serão criadas, mas não haverá arquivos. Pastas vazias não serão criadas. |
| /u | Esta opção só copiará arquivos na origem que já estão no destino. |
| /v | Esta opção verifica cada arquivo conforme foi escrito, com base em seu tamanho, para garantir que sejam idênticos. A verificação foi incorporada ao comando a partir do Windows XP, portanto, essa opção não faz nada em versões posteriores do Windows e é incluída apenas para compatibilidade com arquivos mais antigos do MS-DOS. |
| /w | Use a opção /w para apresentar uma mensagem "Pressione qualquer tecla quando estiver pronto para copiar arquivo(s)". O comando começará a copiar os arquivos conforme as instruções após você confirmar com um pressionamento de tecla. Esta opção não é a mesma que a opção /p que pede a verificação antes de cada cópia do arquivo. |
| /x | Esta opção copia as configurações de auditoria de arquivos e as informações da Lista de Controle de Acesso do Sistema (SACL). Você implica /o quando usa a opção /x. |
| /y | Use esta opção para impedir que o comando solicite a substituição de arquivos da origem que já existem no destino. |
| /-y | Use esta opção para forçar o comando a avisar sobre a substituição de arquivos. Esta pode parecer uma opção estranha de existir, pois este é o comportamento padrão do xcopy, mas a opção /y pode estar predefinida na variável de ambiente COPYCMD em alguns computadores, tornando essa opção necessária. |
| /z | Esta opção permite que o comando xcopy pare de copiar arquivos com segurança quando uma conexão de rede for perdida e, em seguida, retome a cópia de onde parou quando a conexão for restabelecida. Esta opção também mostra a porcentagem copiada para cada arquivo durante o processo de cópia. |
| /exclude: arquivo1 [ + arquivo2][ + arquivo3]… | Esta opção permite que você especifique um ou mais nomes de arquivo contendo uma lista de strings de pesquisa que você deseja que o comando use para determinar os arquivos e/ou pastas a serem ignorados ao copiar. |
| /? | Use a chave de ajuda com xcopy para mostrar ajuda detalhada sobre o comando. Executar xcopy /? é o mesmo que usar o comando help para executar help xcopy. |
O comando xcopy adicionará o atributo archive aos arquivos no destino, não importando se o atributo estava ativado ou desativado no arquivo de origem.
Exemplos de comando Xcopy
A seguir estão vários exemplos de como usar este comando:
Copiar arquivos para uma nova pasta
xcopy C:\Files E:\Files /i
No exemplo acima, os arquivos contidos no diretório de origem de C:\Files são copiados para destination, um novo diretório na unidade E chamado Files.
Nenhum subdiretório, nem qualquer arquivo contido neles, será copiado porque a opção /s não foi usada.
Xcopy Backup Script
xcopy "C:\Arquivos importantes" D:\Backup /c /d /e /h /i /k /q /r /s /x /y
Neste exemplo, o xcopy foi projetado para funcionar como uma solução de backup. Tente isso se quiser usar o xcopy em vez de um programa de software de backup para fazer backup de seus arquivos. Coloque o comando como mostrado acima em um script e agende-o para ser executado todas as noites.
Como mostrado acima, o comando é usado para copiar todos os arquivos e pastas [/s] mais recentes que os já copiados [/d], incluindo pastas vazias [/e] e arquivos ocultos [/h], de origem de C:\Important Files para o destino de D:\Backup, que é um diretório . Temos alguns arquivos somente leitura que queremos manter atualizados no destino [/r] e queremos manter esse atributo depois de copiados [/k]. Também queremos garantir a manutenção de todas as configurações de propriedade e auditoria nos arquivos que estamos copiando [/x]. Finalmente, como estamos executando o xcopy em um script, não precisamos ver nenhuma informação sobre os arquivos à medida que eles são copiados [/q], não queremos ser solicitados a substituir cada um [/y], nem queremos que o comando pare se ocorrer um erro [/c].
Copiar arquivos e pastas pela rede
xcopy C:\Videos "\\SERVER\Media Backup" /f /j /s /w /z
Aqui, o comando é usado para copiar todos os arquivos, subpastas e arquivos contidos nas subpastas [/s] da fonte de C:\Videos para a pasta de destino Media Backup localizada em um computador na rede por o nome do SERVIDOR. Estamos copiando alguns arquivos de vídeo muito grandes, então o buffer deve ser desabilitado para melhorar o processo de cópia [/j], e como estamos copiando pela rede, queremos poder retomar a cópia se perdermos a conexão de rede [/z]. Sendo paranóicos, queremos ser solicitados a iniciar o processo antes que ele realmente faça alguma coisa [/w], e também queremos ver todos os detalhes sobre quais arquivos estão sendo copiados à medida que são copiados [/f].
Estrutura de Pasta Duplicada
xcopy C:\Client032 C:\Client033 /t /e
Neste último exemplo, temos uma fonte cheia de arquivos e pastas bem organizados em C:\Client032 para um cliente. Já criamos uma pasta de destino vazia, Client033, para um novo cliente, mas não queremos nenhum arquivo copiado - apenas a estrutura de pastas vazia [/t] para que estejamos organizados e preparados. Temos algumas pastas vazias em C:\Client032 que podem ser aplicadas ao novo cliente, então queremos ter certeza de que elas também serão copiadas [/e].
Salve a saída às vezes longa do comando xcopy em um arquivo usando um operador de redirecionamento. Aprenda como redirecionar a saída do comando para um arquivo ou confira Truques do Prompt de Comando para mais dicas.
Xcopy & Xcopy32
No Windows 98 e Windows 95, duas versões do comando xcopy estavam disponíveis: xcopy e xcopy32. No entanto, o último comando nunca foi planejado para ser executado diretamente.
Quando você executa o xcopy no Windows 95 ou 98, a versão original de 16 bits é executada automaticamente (no modo MS-DOS) ou a versão mais recente de 32 bits é executada automaticamente (no Windows).
Para ser claro, não importa qual versão do Windows ou MS-DOS você tenha, sempre execute o comando xcopy, não o xcopy32, mesmo que esteja disponível. Quando você executa xcopy, você está sempre executando a versão mais apropriada do comando.
Xcopy Comandos Relacionados
O comando xcopy é semelhante em muitos aspectos ao comando copy, mas com muito mais opções, como a capacidade de copiar pastas, copiar todos os arquivos em subdiretórios e excluir arquivos.
Este comando também é muito parecido com o comando robocopy, exceto que robocopy tem mais flexibilidade do que xcopy.
O comando dir é frequentemente usado com xcopy para verificar quais pastas e arquivos estão em um diretório antes de completar o comando.
