robocopy

Copia dados de arquivo de um local para outro.

Sintaxe

robocopy <source> <destination> [<file>[ ...]] [<options>]

Por exemplo, para copiar um arquivo chamado yearly-report.mov de c:\reports para um compartilhamento de arquivos \\marketing\videos ao habilitar o multi-threading para um desempenho mais alto (com o parâmetro /mt ) e a capacidade de reiniciar a transferência caso ela seja interrompida (com o parâmetro /z ), digite:

robocopy c:\reports "\\marketing\videos" yearly-report.mov /mt /z

Importante

Se algum dado for copiado da raiz de um dispositivo, o diretório de destino adotará o atributo "oculto" durante o processo de cópia.

Parâmetros

Parâmetro Descrição
<source> Especifica o caminho para o diretório de origem.
<destination> Especifica o caminho para o diretório de destino.
<file> Especifica o arquivo ou os arquivos a serem copiados. Há suporte para caracteres curinga (* ou ?). Se você não especificar esse parâmetro, *.* será usado como o valor padrão.
<options> Especifica as opções a serem usadas com o comando robocopy , incluindo opções de cópia, arquivo, repetição, registro em log e trabalho .

Opções de cópia

Opção Descrição
/s Copia subdiretórios. Essa opção exclui automaticamente diretórios vazios.
/e Copia subdiretórios. Essa opção inclui automaticamente diretórios vazios.
/Lev:<n> Copia apenas os n níveis superiores da árvore de diretório de origem.
/z Copia arquivos no modo reinicializável. No modo reinicializável, se uma cópia de arquivo for interrompida, o Robocopy poderá continuar de onde parou em vez de recopiar todo o arquivo.
/b Copia arquivos no modo de backup, permitindo que o Robocopy substitua as ACLs (configurações de permissão de arquivo e pasta). Isso permite a cópia de arquivos aos quais você pode não ter acesso, supondo que ele esteja sendo executado em uma conta com privilégios suficientes.
/zb Copia arquivos no modo reinicializável. Se o acesso ao arquivo for negado, mudará para o modo de backup.
/J Cópias usando E/S não armazenada em buffer (recomendado para arquivos grandes).
/efsraw Copia todos os arquivos criptografados no modo RAW do EFS.
/Cópia:<copyflags> Especifica quais propriedades de arquivo copiar. Os valores válidos para essa opção são:
  • D – Dados
  • A – Atributos
  • T – Carimbos de data/hora
  • X – Ignorar fluxos de dados Alt
  • S – ACL (lista de controle de acesso) do NTFS
  • O – Informações do proprietário
  • U – Informações de auditoria
O valor padrão para a opção /COPY é DAT (dados, atributos e carimbos de data/hora). O sinalizador X será ignorado se /B ou /ZB for usado.
/dcopy:<copyflags> Especifica o que copiar em diretórios. Os valores válidos para essa opção são:
  • D – Dados
  • A – Atributos
  • T – Carimbos de data/hora
  • E – Atributo estendido
  • X – Ignorar fluxos de dados Alt
O valor padrão dessa opção é DA (dados e atributos).
/s Copia arquivos com segurança (equivalente a /copy:DATS).
/copyall Copia todas as informações de arquivo (equivalente a /copy:DATSOU).
/nocopy Não copia nenhuma informação de arquivo (útil com /purge).
/secfix Corrige a segurança do arquivo em todos os arquivos, até mesmo os ignorados.
/timfix Corrige os tempos de arquivo em todos os arquivos, até mesmo os ignorados.
/Purga Exclui arquivos e diretórios de destino que não existem mais na origem. Usar essa opção com a opção /e e um diretório de destino permite que as configurações de segurança do diretório de destino não sejam substituídas.
/Mir Espelha uma árvore de diretório (equivalente a /e mais /purge). Usando essa opção com a opção /e e um diretório de destino, substitui as configurações de segurança do diretório de destino.
/Mov Move arquivos e os exclui da origem depois que eles são copiados.
/Mover Move arquivos e diretórios e os exclui da origem depois que eles são copiados.
/a+:[RASHCNET] Adiciona os atributos especificados aos arquivos copiados. Os valores válidos para essa opção são:
  • R – Somente leitura
  • A – Arquivo Morto
  • S – Sistema
  • H – Oculto
  • C – Compactado
  • N – Conteúdo não indexado
  • E – Criptografado
  • T – Temporário
/a-:[RASHCNETO] Remove os atributos especificados dos arquivos copiados. Os valores válidos para essa opção são:
  • R – Somente leitura
  • A – Arquivo Morto
  • S – Sistema
  • H – Oculto
  • C – Compactado
  • N – Conteúdo não indexado
  • E – Criptografado
  • T – Temporário
  • O – Offline
/Criar Cria apenas uma árvore de diretório e arquivos de comprimento zero.
/Gordura Cria arquivos de destino usando apenas nomes de arquivo FAT de 8,3 caracteres.
/256 Desativa o suporte para caminhos com mais de 256 caracteres.
/Mon:<n> Monitora a origem e é executado novamente quando mais de n alterações são detectadas.
/Mot:<m> Monitora a origem e é executado novamente em m minutos se forem detectadas alterações.
/rh:hhmm-hhmm Especifica os tempos de execução em que novas cópias podem ser iniciadas.
/Pf Verifica os tempos de execução por arquivo (não por passagem).
/Ipg:<n> Especifica a lacuna entre pacotes para liberar a largura de banda em linhas lentas.
/Sj Copia junções (links suaves) para o caminho de destino em vez de destinos de link.
/Sl Não siga links simbólicos e crie uma cópia do link.
/Mt:<n> Cria cópias multi-threaded com n threads. n deve ser um inteiro entre 1 e 128. O valor padrão para n é 8. Para obter um melhor desempenho, redirecione sua saída usando a opção /log .

O parâmetro /mt não pode ser usado com os parâmetros /ipg e /efsraw .

/nodcopy Não copia nenhuma informação de diretório (o padrão /dcopy:DA é feito).
/nooffload Copia arquivos sem usar o mecanismo de descarregamento de cópia do Windows.
/Comprimir Solicita a compactação de rede durante a transferência de arquivo, se aplicável.
/Esparsas Habilita a retenção do estado esparso durante a cópia.

Importante

Ao usar a opção de cópia /secfix , especifique o tipo de informações de segurança que você deseja copiar, usando uma destas opções de cópia adicionais:

  • /copyall
  • /copy:o
  • /copy:s
  • /copy:u
  • /sec

Observação

O parâmetro /mt foi introduzido no Windows Server 2008 R2 e sua funcionalidade se aplica às versões atuais do Windows Server.

Opções de limitação de arquivo de cópia

Opção Descrição
/iomaxsize:<n>[kmg] O tamanho máximo de e/o solicitado por ciclo de leitura/gravação em nkilobytes, megabytes ou gigabytes.
/iorate:<n>[kmg] A taxa de e/o solicitada em nkilobytes megabytes ou gigabytes por segundo.
/threshold:<n>[kmg] O limite de tamanho do arquivo para limitação em nkilobytes, megabytes ou gigabytes (consulte Comentários).

Opções de seleção de arquivo

Opção Descrição
/a Copia somente arquivos para os quais o atributo Archive está definido.
/m Copia somente arquivos para os quais o atributo Archive está definido e redefine o atributo Archive .
/ia:[RASHCNETO] Inclui apenas arquivos para os quais qualquer um dos atributos especificados está definido. Os valores válidos para essa opção são:
  • R – Somente leitura
  • A – Arquivo morto
  • S – Sistema
  • H – Oculto
  • C – Compactado
  • N – Conteúdo não indexado
  • E – Criptografado
  • T – Temporário
  • O – Offline
/Xa:[RASHCNETO] Exclui arquivos para os quais qualquer um dos atributos especificados está definido. Os valores válidos para essa opção são:
  • R – Somente leitura
  • A – Arquivo morto
  • S – Sistema
  • H – Oculto
  • C – Compactado
  • N – Conteúdo não indexado
  • E – Criptografado
  • T – Temporário
  • O – Offline
/Xf <filename>[ ...] Exclui arquivos que correspondem aos nomes ou caminhos especificados. Há suporte para caracteres curinga (* e ?).
/Xd <directory>[ ...] Exclui diretórios que correspondem aos nomes e caminhos especificados.
/Xc Exclui arquivos existentes com o mesmo carimbo de data/hora, mas tamanhos de arquivo diferentes.
/Xn Os arquivos de diretório de origem mais recentes que o destino são excluídos da cópia.
/Xo Arquivos de diretório de origem mais antigos do que o destino são excluídos da cópia.
/Xx Exclui arquivos e diretórios extras presentes no destino, mas não na origem. A exclusão de arquivos extras não excluirá arquivos do destino.
/Xl Exclui arquivos e diretórios "solitários" presentes na origem, mas não no destino. A exclusão de arquivos solitários impede que novos arquivos sejam adicionados ao destino.
/Im Inclua arquivos modificados (tempos de alteração diferentes).
/is Inclui os mesmos arquivos. Os mesmos arquivos são idênticos em nome, tamanho, horas e todos os atributos.
/it Inclui arquivos "ajustados". Os arquivos ajustados têm o mesmo nome, tamanho e horas, mas atributos diferentes.
/Max:<n> Especifica o tamanho máximo do arquivo (para excluir arquivos maiores que n bytes).
/Min:<n> Especifica o tamanho mínimo do arquivo (para excluir arquivos menores que n bytes).
/Maxage:<n> Especifica a idade máxima do arquivo (para excluir arquivos com mais de n dias ou data).
/minage:<n> Especifica a idade mínima do arquivo (excluir arquivos mais recentes que n dias ou data).
/maxlad:<n> Especifica a data máxima de último acesso (exclui arquivos não utilizados desde n).
/minlad:<n> Especifica a data mínima de último acesso (exclui os arquivos usados desde n) Se n for menor que 1900, n especificará o número de dias. Caso contrário, n especifica uma data no formato AAAAMMDD.
/Xj Exclui pontos de junção, que normalmente são incluídos por padrão.
/fft Pressupõe tempos de arquivo FAT (precisão de dois segundos).
/Dst Compensa as diferenças de tempo DST de uma hora.
/xjd Exclui pontos de junção para diretórios.
/xjf Exclui pontos de junção para arquivos.

Opções de repetição

Opção Descrição
/R:<n> Especifica o número de repetições em cópias com falha. O valor padrão de n é 1.000.000 (um milhão de repetições).
/w:<n> Especifica o tempo de espera entre as tentativas, em segundos. O valor padrão de n é 30 (tempo de espera de 30 segundos).
/Reg Salva os valores especificados nas opções /r e /w como configurações padrão no Registro.
/Tbd Especifica que o sistema aguardará a definição dos nomes de compartilhamento (erro de repetição 67).
/lfsm Operar no modo de pouco espaço livre, o que permite copiar, pausar e retomar (consulte Comentários).
/lfsm:<n>[kmg] Especifica o tamanho do piso em nkilobytes, megabytes ou gigabytes.

Opções de log

Opção Descrição
/l Especifica que os arquivos devem ser listados apenas (e não copiados, excluídos ou com carimbo de data/hora).
/x Relata todos os arquivos extras, não apenas os selecionados.
/v Produz uma saída detalhada e mostra todos os arquivos ignorados.
/Ts Inclui carimbos de data/hora do arquivo de origem na saída.
/fp Inclui os nomes de caminho completos dos arquivos na saída.
/bytes Imprime tamanhos como bytes.
/Ns Especifica que os tamanhos de arquivo não devem ser registrados.
/nc Especifica que as classes de arquivo não devem ser registradas.
/nfl Especifica que os nomes de arquivo não devem ser registrados.
/ndl Especifica que os nomes de diretório não devem ser registrados.
/np Especifica que o progresso da operação de cópia (o número de arquivos ou diretórios copiados até o momento) não será exibido.
/Eta Mostra o ETA (tempo estimado de chegada) dos arquivos copiados.
/Log:<logfile> Grava a saída de status no arquivo de log (substitui o arquivo de log existente).
/log+:<logfile> Grava a saída de status no arquivo de log (acrescenta a saída ao arquivo de log existente).
/unilog:<logfile> Grava a saída de status no arquivo de log como texto unicode (substitui o arquivo de log existente).
/unilog+:<logfile> Grava a saída de status no arquivo de log como texto Unicode (acrescenta a saída ao arquivo de log existente).
/tee Grava a saída de status na janela do console e no arquivo de log.
/njh Especifica que não há nenhum cabeçalho de trabalho.
/njs Especifica que não há nenhum resumo do trabalho.
/unicode Exibe a saída de status como texto unicode.

Opções de trabalho

Opção Descrição
/Trabalho:<jobname> Especifica que os parâmetros devem ser derivados do arquivo de trabalho nomeado. Para executar /job:jobname, primeiro você deve executar o /save:jobname parâmetro para criar o arquivo de trabalho.
/Salvar:<jobname> Especifica que os parâmetros devem ser salvos no arquivo de trabalho nomeado. Isso deve ser executado antes de executar /job:jobname. Todas as opções de cópia, repetição e registro em log devem ser especificadas antes desse parâmetro.
/Desistir É encerrado após o processamento da linha de comando (para exibir parâmetros).
/nosd Indica que nenhum diretório de origem foi especificado.
/nodd Indica que nenhum diretório de destino foi especificado.
/Se Inclui os arquivos especificados.

Comentários

  • O uso de /PURGE ou /MIR no diretório raiz do volume anteriormente fazia com que o robocopy aplicasse a operação solicitada em arquivos dentro do diretório Informações de Volume do Sistema também. Esse não é mais o caso como se fosse especificado, o robocopy ignorará todos os arquivos ou diretórios com esse nome nos diretórios de origem e destino de nível superior da sessão de cópia.

  • A classificação de arquivos modificados só se aplica quando os sistemas de arquivos de origem e de destino dão suporte a carimbos de data/hora de alteração, como NTFS, e os arquivos de origem e destino têm tempos de alteração diferentes, mas são os mesmos. Esses arquivos não são copiados por padrão. Especifique /IM para incluí-los.

  • As solicitações de sinalizador /DCOPY:E que a cópia de atributo estendido deve ser tentada para diretórios. O Robocopy continuará se os EAs de um diretório não puderem ser copiados. Esse sinalizador não está incluído em /COPYALL.

  • Se /IoMaxSize ou /IoRate forem especificados, o robocopy habilitará a limitação do arquivo de cópia para reduzir a carga do sistema. Ambos podem ser ajustados para valores ideais e parâmetros de cópia, mas o sistema e o robocopy têm permissão para ajustá-los aos valores permitidos conforme necessário.

  • Se /Threshold for usado, ele especificará um tamanho mínimo de arquivo para envolver a limitação. Os arquivos abaixo desse tamanho não serão limitados. Os valores para todos os três parâmetros podem ser seguidos por um caractere de sufixo opcional, como [KMG] (quilo, mega, giga).

  • O uso de /LFSM solicita que o robocopy opere no "modo de pouco espaço livre". Nesse modo, o robocopy será pausado sempre que uma cópia de arquivo fizer com que o espaço livre do volume de destino fique abaixo de um valor "floor". Esse valor pode ser especificado explicitamente usando o sinalizador /LFSM:n[KMG].

  • Se /LFSM for especificado sem valor de piso explícito, o piso será definido como 10% do tamanho do volume de destino. O modo de espaço livre baixo é incompatível com /MT e /EFSRAW.

Códigos de saída (retorno)

Valor Descrição
0 Nenhum arquivo foi copiado. Nenhuma falha foi encontrada. Nenhum arquivo foi incompatível. Os arquivos já existem no diretório de destino; portanto, a operação de cópia foi ignorada.
1 Todos os arquivos foram copiados com êxito.
2 Há alguns arquivos adicionais no diretório de destino que não estão presentes no diretório de origem. Nenhum arquivo foi copiado.
3 Alguns arquivos foram copiados. Arquivos adicionais estavam presentes. Nenhuma falha foi encontrada.
5 Alguns arquivos foram copiados. Alguns arquivos foram incompatíveis. Nenhuma falha foi encontrada.
6 Existem arquivos adicionais e arquivos incompatíveis. Nenhum arquivo foi copiado e nenhuma falha foi encontrada, o que significa que os arquivos já existem no diretório de destino.
7 Os arquivos foram copiados, uma incompatibilidade de arquivo estava presente e arquivos adicionais estavam presentes.
8 Vários arquivos não foram copiados.

Observação

Qualquer valor igual ou maior que 8 indica que houve pelo menos uma falha durante a operação de cópia.