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 do DOS.
Sintaxe do Comando Xcopy
Use a seguinte sintaxe para o comando xcopy:
xcopy origem [ destino ] [ /a ] [ /b ] [ /c ] [ /d [ : date ]] [ /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 de comando Xcopy | |
|---|---|
| Item | Descrição |
| fonte | Isso define os arquivos ou a pasta de nível superior da qual 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 no destino se ele contiver espaços. |
| /uma | O uso dessa opção copiará apenas os arquivos compactados encontrados no arquivo 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. Essa 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 os 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 é igual a /s , mas também criará pastas vazias no destino que também estavam vazias na origem . 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 | Essa 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. Essa 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. |
| /eu | 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 . |
| /eu | 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 criando um comando complicado com várias opções e quiser ver como ele funcionaria hipoteticamente. |
| /m | Esta opção é idêntica à opção /a , mas o xcopy desligará o atributo de arquivo 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. Essa 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 oferece suporte a nomes de arquivo longos. |
| /o | Retém informações de propriedade e Lista de controle de acesso (ACL) nos arquivos gravados no destino . |
| /p | Ao usar esta opção, você será avisado antes da criação de cada arquivo em destination . |
| /q | Uma espécie de oposto da opção /f , a opção /q colocará o xcopy no modo “silencioso”, ignorando a exibição na tela de cada arquivo que está sendo copiado. |
| /r | Use esta opção para substituir arquivos somente leitura no destino . Se você não usar essa opção quando quiser substituir um arquivo somente leitura em destination , receberá uma mensagem “Acesso negado” e o comando deixará de ser executado. |
| /s | Use esta opção para copiar diretórios, subdiretórios e os arquivos contidos neles, além dos arquivos na raiz de source . As 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. |
| /você | Esta opção só copiará os arquivos na origem que já estão no destino . |
| /v | Essa opção verifica cada arquivo conforme está 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 MS-DOS mais antigos. |
| /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 instruído após você confirmar com um pressionamento de tecla. Esta opção não é a mesma que a opção /p que pede verificação antes de cada cópia de arquivo. |
| /x | Esta opção copia as configurações de auditoria de arquivo e as informações da Lista de Controle de Acesso do Sistema (SACL). Você implica /o quando usa a opção /x . |
| /a | Use essa 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 avisá-lo sobre a substituição de arquivos. Isso pode parecer uma opção estranha de existir, pois esse é 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 | Essa 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. |
| /excluir: arquivo1 [ + arquivo2 ][ + arquivo3 ]… | Esta opção permite especificar um ou mais nomes de arquivo contendo uma lista de strings de pesquisa que você deseja que o comando use para determinar arquivos e/ou pastas a serem ignorados ao copiar. |
| /? | Use a opção de ajuda com xcopy para mostrar ajuda detalhada sobre o comando. Executando xcopy /? é o mesmo que usar o comando help para executar help xcopy . |
O comando xcopy adicionará o atributo archive aos arquivos no destino , independentemente de o atributo estar ativado ou desativado no arquivo na origem .
Exemplos de Comandos Xcopy
A seguir estão vários exemplos de como usar este comando:
Copiar arquivos para uma nova pasta
xcopy C:\Files E:\Files /iNo exemplo acima, os arquivos contidos no diretório de origem de C:\Files são copiados para destination , um novo diretório [/i] na unidade E chamado Files .
Nenhum subdiretório, nem nenhum arquivo contido neles, será copiado porque a opção /s não foi usada.
Script de Backup Xcopy
xcopy "C:\Important Files" D:\Backup /c /d /e /h /i /k /q /r /s /x /yNeste 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], da fonte de C:\ Arquivos importantes para o destino de D:\Backup , que é um diretório [/i]. Temos alguns arquivos somente leitura que queremos manter atualizados no destino [/r] e queremos manter esse atributo após ser copiado [/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 /zAqui, o comando é usado para copiar todos os arquivos, subpastas e arquivos contidos nas subpastas [/s] da origem de C:\Videos para a pasta de destino Media Backup localizada em um computador na rede com o nome de SERVER .
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 pastas duplicadas
xcopy C:\Client032 C:\Client033 /t /eNeste exemplo final, 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 que nenhum arquivo seja copiado – apenas a estrutura de pastas vazia [/t] para que estejamos organizados e preparados. Temos algumas pastas vazias em C:\Client032 que podem se aplicar ao novo cliente, então queremos ter certeza de que elas também sejam copiadas [/e].
Xcopy & Xcopy32
No Windows 98 e no 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. Ao executar o xcopy, você está sempre executando a versão mais apropriada do comando.
Comandos relacionados ao Xcopy
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 o robocopy tem mais flexibilidade do que o xcopy.
O comando dir é frequentemente usado com xcopy para verificar quais pastas e arquivos estão em um diretório antes de concluir o comando.
