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:
|
/dcopy:<copyflags> |
Especifica o que copiar em diretórios. Os valores válidos para essa opção são:
|
| /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:
|
| /a-:[RASHCNETO] | Remove os atributos especificados dos arquivos copiados. Os valores válidos para essa opção são:
|
| /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:
|
/Xa:[RASHCNETO] |
Exclui arquivos para os quais qualquer um dos atributos especificados está definido. Os valores válidos para essa opção são:
|
/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.