Sdílet prostřednictvím


robocopy

Zkopíruje data souboru z jednoho umístění do jiného.

Syntax

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

Chcete-li například zkopírovat soubor s názvem yearly-report.mov z adresáře c:\rse přenese do sdílené složky \\marketing\videos a zároveň povolí vícevláknové zpracování pro vyšší výkon (s parametrem /mt ) a možnost restartovat přenos v případě jeho přerušení (s parametrem /z ), zadejte:

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

Important

Pokud jsou nějaká data zkopírována z kořenového adresáře zařízení, cílový adresář během procesu kopírování převezme atributy "skrytý" a "systémový".

Parameters

Parameter Description
<source> Určuje cestu ke zdrojovému adresáři.
<destination> Určuje cestu k cílovému adresáři.
<file> Určuje soubor nebo soubory, které se mají zkopírovat. Jsou podporovány zástupné znaky (* nebo ?). Pokud tento parametr nezadáte, *.* se použije jako výchozí hodnota.
<options> Určuje volby, které se mají použít s příkazem robocopy , včetně možností kopírování, souboru, opakování, protokolování a úlohy .

Copy options

Option Description
/s Copies subdirectories. Tato možnost automaticky vylučuje prázdné adresáře.
/e Copies subdirectories. Tato možnost automaticky obsahuje prázdné adresáře.
/lev:<n> Zkopíruje pouze horních n úrovní zdrojového adresářového stromu.
/z Zkopíruje soubory v restartovatelném režimu. Pokud by se v restartovatelném režimu přerušila kopie souboru, může robocopy vyzvednout místo toho, aby znovu zkopírovala celý soubor.
/b Zkopíruje soubory v režimu zálohování. V režimu zálohování robocopy přepíše nastavení oprávnění souborů a složek (ACL), které by jinak mohlo blokovat přístup.
/zb Zkopíruje soubory v restartovatelném režimu. Pokud je přístup k souborům odepřen, přepne do režimu zálohování.
/j Kopie s využitím nepřipojených vstupně-výstupních operací (doporučeno pro velké soubory)
/efsraw Zkopíruje všechny šifrované soubory v režimu EFS RAW.
/copy:<copyflags> Určuje, které vlastnosti souboru se mají kopírovat. Platné hodnoty pro tuto možnost jsou:
  • D - Data
  • A - Atributy
  • T - Časová razítka
  • X - Přeskočit alternativní datové proudy
  • S - Seznam řízení přístupu (ACL) systému NTFS
  • O - Informace o vlastníkovi
  • U - Informace o auditu
Výchozí hodnota pro možnost /COPY je DAT (data, atributy a časová razítka). Příznak X se ignoruje, pokud je použit parametr /B nebo /ZB .
/dcopy:<copyflags> Určuje, co se má kopírovat v adresářích. Platné hodnoty pro tuto možnost jsou:
  • D - Data
  • A - Atributy
  • T - Časová razítka
  • E – Rozšířený atribut
  • X - Přeskočit alternativní datové proudy
Výchozí hodnota pro tuto volbu je DA (data a atributy).
/sec Zkopíruje soubory se zabezpečením (ekvivalent k /copy:DATS).
/copyall Zkopíruje všechny informace o souboru (ekvivalent k /copy:DATSOU).
/nocopy Nekopíruje žádné informace o souboru (užitečné s /purge).
/secfix Opravuje zabezpečení souborů u všech souborů, dokonce i přeskočených souborů.
/timfix Opravuje časy souborů u všech souborů, dokonce i přeskočeny.
/purge Odstraní cílové soubory a adresáře, které již ve zdroji neexistují. Použití této možnosti s možností /e a cílovým adresářem umožní, aby nedošlo k přepsání nastavení zabezpečení cílového adresáře.
/mir Zrcadlí adresářový strom (ekvivalent /e plus /purge). Při použití této volby s parametrem /e a cílovým adresářem se přepíše nastavení zabezpečení cílového adresáře.
/mov Přesune soubory a po zkopírování je odstraní ze zdroje.
/move Přesune soubory a adresáře a odstraní je ze zdroje po zkopírování.
/a+:[RASHCNET] Přidá zadané atributy ke zkopírovaným souborům. Platné hodnoty pro tuto možnost jsou:
  • R – Jen ke čtení
  • A - Archiv
  • S - Systém
  • H - Skrytý
  • C - Komprimovaný
  • N - Není indexováno podle obsahu
  • E – Šifrováno
  • T - Dočasné
/a-:[RASHCNETO] Odebere zadané atributy zkopírovaných souborů. Platné hodnoty pro tuto možnost jsou:
  • R – Jen ke čtení
  • A - Archiv
  • S - Systém
  • H - Skrytý
  • C - Komprimovaný
  • N - Není indexováno podle obsahu
  • E – Šifrováno
  • T - Dočasné
  • O - Offline
/create Vytvoří pouze adresářový strom a soubory s nulovou délkou.
/fat Vytvoří cílové soubory pouze pomocí názvů souborů FAT s délkou 8,3 znaků.
/256 Vypne podporu cest delších než 256 znaků.
/mon:<n> Monitoruje zdroj a spustí se znovu, pokud je zjištěno více než n změn.
/mot:<m> Monitoruje zdroj a v případě zjištění změn se znovu spustí za m minut.
/rh:hhmm-hhmm Určuje dobu spuštění, kdy lze spustit nové kopie.
/pf Kontroluje časy spuštění v jednotlivých souborech (nikoli při průchodu).
/ipg:<n> Určuje mezeru mezi pakety pro uvolnění šířky pásma na pomalých linkách.
/sj Zkopíruje spojení (soft-links) do cílové cesty místo cílů propojení.
/sl Nepoužívejte symbolické odkazy a místo toho vytvořte kopii odkazu.
/mt:<n> Vytvoří vícevláknové kopie s n zřetězením. n musí být celé číslo v rozmezí od 1 do 128. Výchozí hodnota pro n je 8. Chcete-li dosáhnout lepšího výkonu, přesměrujte výstup pomocí možnosti /log .

Parametr /mt nelze použít s parametry /ipg a /efsraw .

/nodcopy Nekopíruje žádné informace o adresáři (výchozí /dcopy:DA je hotovo).
/nooffload Zkopíruje soubory bez použití mechanismu přesměrování zpracování kopírování systému Windows.
/compress V případě potřeby požádá o kompresi sítě během přenosu souborů.
/sparse:<y|n> Povolí nebo zakáže zachování zhuštěného stavu souborů během procesu kopírování. Pokud není vybraná žádná volba, použije se výchozí hodnota ano (povoleno).
/noclone Nepokouší se blokovat klonování jako optimalizace.

Important

Při použití možnosti kopírování /secfix určete typ bezpečnostních informací, které chcete zkopírovat, pomocí jedné z těchto dalších voleb kopírování:

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

Note

Parametr /mt byl zaveden v systému Windows Server 2008 R2 a jeho funkce se vztahuje na aktuální verze systému Windows Server.

Možnosti omezení kopírování souboru

Option Description
/iomaxsize:<n>[kmg] Požadovaná maximální velikost vstupně-výstupních operací na cyklus čtení/zápisu v nkilobajtech, megabajtech nebo gigabajtech.
/iorate:<n>[kmg] Požadovaná vstupně-výstupní rychlost v nkilobajtů megabajtů nebo gigabajtů za sekundu.
/threshold:<n>[kmg] Prahová hodnota velikosti souboru pro omezení v nkilobajtů, megabajtů nebo gigabajtů (viz Poznámky).

Tyto možnosti omezování se používají k určení maximální šířky pásma vstupně-výstupních operací, kterou Robocopy umožňuje používat v bajtech za sekundu. Pokud se nezadává v bajtech za sekundu, lze použít celá čísla, pokud jsou zadána k, m nebo g . Minimální šířka pásma vstupně-výstupních operací, která je omezena, je 524288 bajtů, i když je zadána nižší hodnota.

Možnosti výběru souboru

Option Description
/a Zkopíruje pouze soubory, pro které je nastaven atribut Archiv .
/m Zkopíruje pouze soubory, pro které je nastaven atribut Archivovat , a obnoví atribut Archivovat .
/ia:[RASHCNETO] Obsahuje pouze soubory, pro které jsou nastaveny všechny zadané atributy. Platné hodnoty pro tuto možnost jsou:
  • R – Jen ke čtení
  • A - Archiv
  • S - Systém
  • H - Skrytý
  • C - Komprimovaný
  • N - Není indexováno podle obsahu
  • E – Šifrováno
  • T - Dočasné
  • O - Offline
/xa:[RASHCNETO] Vyloučí soubory, pro které jsou nastaveny některé ze zadaných atributů. Platné hodnoty pro tuto možnost jsou:
  • R – Jen ke čtení
  • A - Archiv
  • S - Systém
  • H - Skrytý
  • C - Komprimovaný
  • N - Není indexováno podle obsahu
  • E – Šifrováno
  • T - Dočasné
  • O - Offline
/xf <filename>[ ...] Vyloučí soubory, které odpovídají zadaným názvům nebo cestám. Jsou podporovány zástupné znaky (* a ?).
/Xd <directory>[ ...] Vyloučí adresáře, které odpovídají zadaným názvům a cestám.
/xc Vyloučí existující soubory se stejným časovým razítkem, ale různými velikostmi souborů.
/xn Zdrojové soubory adresáře novější, než je cíl, jsou z kopie vyloučeny.
/xo Zdrojové soubory adresáře starší než cíl jsou z kopie vyloučené.
/xx Vyloučí nadbytečné soubory a adresáře, které jsou přítomné v cíli, ale ne zdroj. Vyloučení dalších souborů neodstraní soubory z cíle.
/xl Vyloučí "osamělé" soubory a adresáře, které jsou přítomné ve zdroji, ale ne v cíli. Vyloučení osamělých souborů brání přidání nových souborů do cíle.
/im Zahrnout změněné soubory (rozdílové časy změn)
/is Obsahuje stejné soubory. Stejné soubory jsou identické v názvu, velikosti, čase a všech atributech.
/it Obsahuje "vylepšené" soubory. Vylepšené soubory mají stejný název, velikost a časy, ale různé atributy.
/max:<n> Určuje maximální velikost souboru (vyloučí soubory větší než n bajtů).
/min:<n> Určuje minimální velikost souboru (pro vyloučení souborů menších než n bajtů).
/maxage:<n> Určuje maximální stáří souboru pro vyloučení souborů starších než n dní nebo datum podle toho, kdy byly soubory naposledy změněny.
/minage:<n> Určuje minimální stáří souboru pro vyloučení souborů novějších než n dní nebo datum podle toho, kdy byly soubory naposledy změněny.
/maxlad:<n> Určuje maximální datum posledního přístupu (vyjma souborů nepoužitých od n).
/minlad:<n> Určuje minimální datum posledního přístupu (vyloučí soubory použité od n) Pokud je n menší než 1900, n určuje počet dní. V opačném případě n určuje datum ve formátu RRRRMMDD.
/xj Vyloučí spojovací body, které jsou standardně zahrnuty.
/fft Předpokládá časy souborů FAT (dvousekundová přesnost).
/dst Kompenzuje rozdíly mezi hodinovým časem DST.
/xjd Vyloučí spojovací body pro adresáře.
/xjf Vyloučí spojovací body pro soubory.

Retry options

Option Description
/r:<n> Určuje počet opakování u neúspěšných kopií. Výchozí hodnota n je 1 000 000 (jeden milion opakování).
/w:<n> Určuje dobu čekání mezi opakovanými pokusy v sekundách. Výchozí hodnota n je 30 (doba čekání 30 sekund).
/reg Uloží hodnoty zadané v možnostech /r a /w jako výchozí nastavení v registru.
/tbd Určuje, že systém čeká na definování názvů sdílených složek (chyba opakování 67).
/lfsm Pracujte v režimu nedostatku volného místa, který umožňuje kopírování, pozastavení a obnovení (viz Poznámky).
/lfsm:<n>[kmg] Určuje velikost podlahy v nkilobajtů, megabajtů nebo gigabajtů.

Logging options

Option Description
/l Určuje, že soubory mají být uvedeny pouze (a nikoli zkopírovány, odstraněny nebo časové razítko).
/x Zobrazí všechny další soubory, nejen ty, které jsou vybrané.
/v Vytvoří podrobný výstup a zobrazí všechny přeskočené soubory.
/ts Do výstupu se zahrnou časová razítka zdrojového souboru.
/fp Zahrne názvy úplných cest souborů ve výstupu.
/bytes Vytiskne velikosti jako bajty.
/ns Určuje, že se soubory nemají protokolovat.
/nc Určuje, že třídy souborů se nemají protokolovat.
/nfl Určuje, že názvy souborů se nemají protokolovat.
/ndl Určuje, že názvy adresářů se nemají protokolovat.
/np Určuje, že se nezobrazuje průběh operace kopírování (počet souborů nebo adresářů, které se zatím zkopírovaly).
/eta Zobrazuje odhadovaný čas přijetí (ETA) zkopírovaných souborů.
/log:<logfile> Zapíše výstup stavu do souboru protokolu (přepíše existující soubor protokolu).
/log+:<logfile> Zapíše výstup stavu do souboru protokolu (připojí výstup k existujícímu souboru protokolu).
/unilog:<logfile> Zapíše výstup stavu do souboru protokolu jako text unicode (přepíše existující soubor protokolu).
/unilog+:<logfile> Zapíše výstup stavu do souboru protokolu jako text Unicode (připojí výstup k existujícímu souboru protokolu).
/tee Zapíše výstup stavu do okna konzoly a do souboru protokolu.
/njh Určuje, že neexistuje žádná hlavička úlohy.
/njs Určuje, že neexistuje žádný souhrn úloh.
/unicode Zobrazí výstup stavu jako text unicode.

Job options

Option Description
/job:<jobname> Určuje, že parametry mají být odvozeny z pojmenovaného souboru úlohy. Pokud chcete spustit /job:jobname, musíte nejprve spustit parametr /save:jobname a vytvořit soubor úlohy.
/save:<jobname> Určuje, že parametry se mají uložit do pojmenovaného souboru úlohy. Tato funkce musí být spuštěna před spuštěním /job:jobname. Před tímto parametrem musí být zadány všechny možnosti kopírování, opakování a protokolování.
/quit Po zpracování příkazového řádku (pro zobrazení parametrů) se ukončí.
/nosd Označuje, že není zadán žádný zdrojový adresář.
/nodd Označuje, že není zadán žádný cílový adresář.
/if Zahrnuje zadané soubory.

Remarks

  • Použití parametrů /PURGE nebo /MIR v kořenovém adresáři svazku dříve způsobilo, že nástroj robocopy použil požadovanou operaci také na soubory v adresáři System Volume Information. Tento případ už není stejný, jako kdyby byl zadán, robocopy přeskočí všechny soubory nebo adresáře s tímto názvem ve zdrojovém a cílovém adresáři relace kopírování na nejvyšší úrovni.

  • Klasifikace upravených souborů platí jenom v případě, že zdrojový i cílový systém souborů podporuje časová razítka změn, jako je NTFS a zdrojové a cílové soubory mají jiné časy změn, ale jinak jsou stejné. Tyto soubory se ve výchozím nastavení nekopírují. Zadejte /IM pro jejich zahrnutí.

  • Příznak /DCOPY:E požaduje, aby byl proveden pokus o rozšířené kopírování atributů pro adresáře. Robocopy pokračuje v operaci kopírování, i když se nepodařilo zkopírovat EA adresáře. Tento příznak není součástí /COPYALL.

  • Pokud je zadán parametr /IoMaxSize nebo /IoRate , nástroj robocopy povolí omezení kopírování souborů, aby se snížilo zatížení systému. Obě možnosti lze upravit tak, aby odpovídaly optimálním hodnotám a parametrům kopírování, ale systém a robocopy je mohou podle potřeby upravit tak, aby povolovaly hodnoty.

  • Pokud je použit parametr /Threshold , určuje minimální velikost souboru pro použití omezování. Soubory pod danou velikostí nejsou omezeny. Za hodnotami pro všechny tři parametry může následovat volitelný znak přípony, například [KMG] (kilobajtů, megabajty, gigabajty).

  • Použití /LFSM požaduje robocopy pro provoz v režimu nízkého volného místa. V tomto režimu robocopy pozastaví pokaždé, když kopie souboru způsobí, že volné místo cílového svazku přejde pod hodnotu floor. Tuto hodnotu lze explicitně zadat pomocí příznaku /LFSM:n[KMG].

  • Pokud je zadán parametr /LFSM bez explicitní hodnoty floor, podlaha se nastaví na 10% velikosti cílového svazku. Režim nedostatku volného místa není kompatibilní s /MT a /EFSRAW.

Ukončovací (návratové) kódy

Value Description
0 Nebyly zkopírovány žádné soubory. Nebyla zjištěna žádná chyba. Nebyly nalezeny žádné soubory. Soubory již existují v cílovém adresáři; operace kopírování se proto přeskočila.
1 Všechny soubory byly úspěšně zkopírovány.
2 V cílovém adresáři jsou některé další soubory, které nejsou ve zdrojovém adresáři. Nebyly zkopírovány žádné soubory.
3 Některé soubory byly zkopírovány. Byly přítomny další soubory. Nebyla zjištěna žádná chyba.
5 Některé soubory byly zkopírovány. Některé soubory se neshodovaly. Nebyla zjištěna žádná chyba.
6 Existují další soubory a neodpovídající soubory. Nebyly zkopírovány žádné soubory a nebyly zjištěny žádné chyby, což znamená, že soubory již existují v cílovém adresáři.
7 Soubory se zkopírovaly, došlo k neshodě souborů a byly přítomny další soubory.
8 Několik souborů se nekopírovalo.

Note

Jakákoli hodnota rovna nebo větší než 8 znamená, že během operace kopírování došlo alespoň k jedné chybě.

Examples

Při spuštění příkazu robocopy důrazně doporučujeme vytvořit soubor protokolu, který se dá zobrazit po dokončení procesu ověření jeho integrity. V následujících příkladech každý používá parametr /LOG:. Pokud chcete ke stejnému souboru protokolu připojit všechny informace protokolu, použijte místo toho parametr /LOG+:.

Pokud chcete zkopírovat všechny soubory a podadresáře, včetně prázdných adresářů, ze složky Records do složky Backup na jednotce D zadejte:

robocopy C:\Users\Admin\Records D:\Backup /E /ZB /LOG:C:\Logs\Backup.log

Pokud chcete zrcadlit obsah složky Records do složky Backup na jednotce D, odstraňte všechny soubory v cíli, které ve zdroji neexistují, s 2 opakovanými pokusy a čekáním 5 sekund mezi jednotlivými opakováními zadejte:

robocopy C:\Users\Admin\Records D:\Backup /MIR /R:2 /W:5 /LOG:C:\Logs\Backup.log

Pokud chcete zkopírovat všechny soubory a podadresáře, které nejsou ze složky Records prázdné, do složky Backup na jednotce D, zachovat data souboru, atributy a časové razítko s operací kopírování s více vlákny, zadejte:

robocopy C:\Users\Admin\Records D:\Backup /S /E /COPY:DAT /MT:16 /LOG:C:\Logs\Backup.log

Pokud chcete přesunout soubory a podadresáře s výjimkou prázdných adresářů, ze složky Records do složky Backup na jednotce D a vyloučit soubory starší než 7 dnů, zadejte:

robocopy C:\Users\Admin\Records D:\Backup /S /MAXAGE:7 /MOV /LOG:C:\Logs\Backup.log

Pokud chcete zkopírovat všechny soubory a podadresáře, včetně prázdných adresářů, ze složky Records do složky Backup na jednotce D s odhadovaným časem pro každý soubor a odstranit všechny soubory a adresáře v cíli, které neexistují ze zdroje, zadejte:

robocopy C:\Users\Admin\Records D:\Backup /ETA /PURGE /LOG:C:\Logs\Backup.log

Pokud chcete zkopírovat všechny soubory a podadresáře ze složky s názvem "Records" na jednotce "C" do složky s názvem "Backup" na jednotce "D" při omezení rychlosti vstupně-výstupních operací na 1 megabajt za sekundu během operace kopírování, zadejte:

robocopy C:\Records D:\Backup /iorate:1m

Pokud chcete přeskočit kopírování souborů ze zdrojové složky do cílové složky, pokud už soubory v cílové složce existují, bez ohledu na to, jestli jsou novější, starší nebo změněné, zadejte:

robocopy C:\Source C:\Destination /XC /XN /XO
  • Command-Line syntaxe