Dela via


robocopy

Kopierar fildata från en plats till en annan.

Syntax

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

Om du till exempel vill kopiera en fil med namnet yearly-report.mov från c:\reporterar till en filresurs \\marketing\videos samtidigt som du aktiverar multitrådning för högre prestanda (med parametern /mt ) och möjligheten att starta om överföringen om den avbryts (med parametern /z ) skriver du:

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

Important

Om data kopieras från roten på en enhet antar målkatalogen attributen "hidden" och "system" under kopieringsprocessen.

Parameters

Parameter Description
<source> Anger sökvägen till källkatalogen.
<destination> Anger sökvägen till målkatalogen.
<file> Anger den fil eller de filer som ska kopieras. Jokertecken (* eller ?) stöds. Om du inte anger den här parametern används *.* som standardvärde.
<options> Anger de alternativ som ska användas med robocopy-kommandot , inklusive alternativ för kopiering,fil, återförsök, loggning och jobb .

Copy options

Option Description
/s Copies subdirectories. Det här alternativet exkluderar automatiskt tomma kataloger.
/e Copies subdirectories. Det här alternativet innehåller automatiskt tomma kataloger.
/lev:<n> Kopierar endast de n översta nivåerna i källkatalogträdet.
/z Kopierar filer i omstartsbart läge. Om en filkopia avbryts i omstartsbart läge kan robocopy fortsätta där den slutade i stället för att kopiera hela filen igen.
/b Kopierar filer i säkerhetskopieringsläge. I säkerhetskopieringsläge åsidosätter robocopy inställningar för fil- och mappbehörighet (ACL), som annars kan blockera åtkomst.
/zb Kopierar filer i omstartsbart läge. Om filåtkomst nekas växlar du till säkerhetskopieringsläge.
/j Kopior med obufferterad I/O (rekommenderas för stora filer).
/efsraw Kopierar alla krypterade filer i EFS RAW-läge.
/copy:<copyflags> Anger vilka filegenskaper som ska kopieras. De giltiga värdena för det här alternativet är:
  • D - Uppgifter
  • A - Attribut
  • T - Tidsstämplar
  • X – Hoppa över alt-dataströmmar
  • S – NTFS-åtkomstkontrollista (ACL)
  • O - Information om ägare
  • U - Revisionsinformation
Standardvärdet för alternativet /COPY är DAT (data, attribut och tidsstämplar). X-flaggan ignoreras om antingen /B eller /ZB används.
/dcopy:<copyflags> Anger vad som ska kopieras i kataloger. De giltiga värdena för det här alternativet är:
  • D - Uppgifter
  • A - Attribut
  • T - Tidsstämplar
  • E – Utökat attribut
  • X – Hoppa över alt-dataströmmar
Standardvärdet för det här alternativet är DA (data och attribut).
/sec Kopierar filer med säkerhet (motsvarande /copy:DATS).
/copyall Kopierar all filinformation (motsvarar /copy:DATSOU).
/nocopy Kopierar ingen filinformation (användbart med /purge).
/secfix Åtgärdar filsäkerhet på alla filer, även överhoppade filer.
/timfix Åtgärdar filtider på alla filer, även överhoppade.
/purge Tar bort målfiler och kataloger som inte längre finns i källan. Om du använder det här alternativet med alternativet /e och en målkatalog kan målkatalogens säkerhetsinställningar inte skrivas över.
/mir Speglar ett katalogträd (motsvarar /e plus /purge). Om du använder det här alternativet med alternativet /e och en målkatalog skrivs målkatalogens säkerhetsinställningar över.
/mov Flyttar filer och tar bort dem från källan när de har kopierats.
/move Flyttar filer och kataloger och tar bort dem från källan när de har kopierats.
/a+:[RASHCNET] Lägger till de angivna attributen i kopierade filer. De giltiga värdena för det här alternativet är:
  • R - Skrivskyddad
  • A - Arkiv
  • S - System
  • H - Dold
  • C - Komprimerad
  • N – Inte indexerat innehåll
  • E - Krypterat
  • T - Temporär
/a-:[RASHCNETO] Tar bort de angivna attributen från kopierade filer. De giltiga värdena för det här alternativet är:
  • R - Skrivskyddad
  • A - Arkiv
  • S - System
  • H - Dold
  • C - Komprimerad
  • N – Inte indexerat innehåll
  • E - Krypterat
  • T - Temporär
  • O - Offline
/create Skapar endast ett katalogträd och filer med noll längd.
/fat Skapar målfiler med endast 8,3 tecken långa FAT-filnamn.
/256 Inaktiverar stöd för sökvägar som är längre än 256 tecken.
/mon:<n> Övervakar källan och körs igen när fler än n ändringar upptäcks.
/mot:<m> Övervakar källan och körs igen om m minuter om ändringar upptäcks.
/rh:hhmm-hhmm Anger körningstider när nya kopior kan startas.
/pf Kontrollerar körningstiderna per fil (inte per pass).
/ipg:<n> Anger skillnaden mellan paket för att frigöra bandbredd på långsamma linjer.
/sj Kopierar korsningar (mjuka länkar) till målsökvägen i stället för länkmål.
/sl Följ inte symboliska länkar och skapa i stället en kopia av länken.
/mt:<n> Skapar flertrådade kopior med n trådar. n måste vara ett heltal mellan 1 och 128. Standardvärdet för n är 8. För bättre prestanda omdirigerar du dina utdata med hjälp av /log alternativet .

Parametern /mt kan inte användas med parametrarna /ipg och /efsraw .

/nodcopy Kopierar ingen kataloginformation (standard /dcopy:DA är klar).
/nooffload Kopierar filer utan att använda mekanismen Windows Copy Offload.
/compress Begär nätverkskomprimering under filöverföring, om tillämpligt.
/sparse:<y|n> Aktiverar eller inaktiverar behåller det glesa tillståndet för filer under kopieringsprocessen. Om inget alternativ är markerat är det som standard Ja (aktiverat).
/noclone Försöker inte blockera kloning som en optimering.

Important

När du använder kopieringsalternativet /secfix anger du vilken typ av säkerhetsinformation du vill kopiera med något av följande ytterligare kopieringsalternativ:

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

Note

Parametern /mt introducerades i Windows Server 2008 R2 och dess funktioner gäller för aktuella versioner av Windows Server.

Alternativ för kopiering av filbegränsning

Option Description
/iomaxsize:<n>[kmg] Den begärda maximala I/O-storleken per läs-/skrivcykel i nkilobyte, megabyte eller gigabyte.
/iorate:<n>[kmg] Den begärda I/O-hastigheten i nkilobyte megabyte eller gigabyte per sekund.
/threshold:<n>[kmg] Tröskelvärdet för filstorlek för begränsning i nkilobyte, megabyte eller gigabyte (se Kommentarer).

Dessa begränsningsalternativ används för att ange den maximala I/O-bandbredd som Robocopy tillåter att användas i byte per sekund. Om det inte anges i byte per sekund kan heltal användas om k, m eller g anges. Den minsta I/O-bandbredden som begränsas är 524288 byte även om ett mindre värde anges.

Alternativ för filval

Option Description
/a Kopierar endast filer för vilka attributet Arkiv har angetts.
/m Kopierar endast filer som attributet Arkiv har angetts för och återställer attributet Arkiv .
/ia:[RASHCNETO] Innehåller endast filer som något av de angivna attributen har angetts för. De giltiga värdena för det här alternativet är:
  • R - Skrivskyddad
  • A - Arkiv
  • S - System
  • H - Dold
  • C - Komprimerad
  • N – Inte indexerat innehåll
  • E - Krypterat
  • T - Temporär
  • O - Offline
/xa:[RASHCNETO] Exkluderar filer som något av de angivna attributen har angetts för. De giltiga värdena för det här alternativet är:
  • R - Skrivskyddad
  • A - Arkiv
  • S - System
  • H - Dold
  • C - Komprimerad
  • N – Inte indexerat innehåll
  • E - Krypterat
  • T - Temporär
  • O - Offline
/xf <filename>[ ...] Exkluderar filer som matchar de angivna namnen eller sökvägarna. Jokertecken (* och ?) stöds.
/Xd <directory>[ ...] Utesluter kataloger som matchar de angivna namnen och sökvägarna.
/xc Exkluderar befintliga filer med samma tidsstämpel, men olika filstorlekar.
/xn Källkatalogfiler som är nyare än målet undantas från kopian.
/xo Källkatalogfiler som är äldre än målet undantas från kopian.
/xx Exkluderar extra filer och kataloger som finns i målet men inte källan. Exkluderande extra filer tar inte bort filer från målet.
/xl Exkluderar "ensamma" filer och kataloger som finns i källan men inte målet. Om du undantar ensamma filer förhindras alla nya filer från att läggas till i målet.
/im Inkludera ändrade filer (olika ändringstider).
/is Innehåller samma filer. Samma filer är identiska i namn, storlek, tider och alla attribut.
/it Innehåller "tweaked"-filer. Justerade filer har samma namn, storlek och tider, men olika attribut.
/max:<n> Anger den maximala filstorleken (för att undanta filer som är större än n byte).
/min:<n> Anger den minsta filstorleken (för att undanta filer som är mindre än n byte).
/maxage:<n> Anger den maximala filåldern för att undanta filer som är äldre än n dagar eller ett datum baserat på när filerna senast ändrades.
/minage:<n> Anger den lägsta filåldern för att undanta filer som är nyare än n dagar eller ett datum baserat på när filerna senast ändrades.
/maxlad:<n> Anger det maximala senaste åtkomstdatumet (exklusive filer som inte används sedan n).
/minlad:<n> Anger det minsta senaste åtkomstdatumet (exklusive filer som används sedan n) Om n är mindre än 1900 anger n antalet dagar. I annat fall anger n ett datum i formatet ÅÅÅÅMMDD.
/xj Exkluderar knutpunkter som normalt ingår som standard.
/fft Förutsätter FAT-filtider (två sekunders precision).
/dst Kompenserar för skillnader i DST-tid på en timme.
/xjd Exkluderar knutpunkter för kataloger.
/xjf Exkluderar knutpunkter för filer.

Retry options

Option Description
/r:<n> Anger antalet återförsök på misslyckade kopior. Standardvärdet n är 1 000 000 (en miljon återförsök).
/w:<n> Anger väntetiden mellan återförsök i sekunder. Standardvärdet för n är 30 (väntetid 30 sekunder).
/reg Sparar de värden som anges i alternativen /r och /w som standardinställningar i registret.
/tbd Anger att systemet väntar på att resursnamn ska definieras (försök igen 67).
/lfsm Använd läget för lite ledigt utrymme som gör det möjligt att kopiera, pausa och återuppta (se Anmärkningar).
/lfsm:<n>[kmg] Anger golvstorleken i nkilobyte, megabyte eller gigabyte.

Logging options

Option Description
/l Anger att filer endast ska visas (och inte kopieras, tas bort eller tidsstämplas).
/x Rapporterar alla extra filer, inte bara de som är markerade.
/v Genererar utförliga utdata och visar alla överhoppade filer.
/ts Innehåller tidsstämplar för källfiler i utdata.
/fp Innehåller de fullständiga sökvägsnamnen för filerna i utdata.
/bytes Skriver ut storlekar som byte.
/ns Anger att filstorlekar inte ska loggas.
/nc Anger att filklasser inte ska loggas.
/nfl Anger att filnamn inte ska loggas.
/ndl Anger att katalognamn inte ska loggas.
/np Anger att kopieringsåtgärden inte ska visas (antalet filer eller kataloger som kopierats hittills).
/eta Visar den uppskattade ankomsttiden (ETA) för de kopierade filerna.
/log:<logfile> Skriver statusutdata till loggfilen (skriver över den befintliga loggfilen).
/log+:<logfile> Skriver statusutdata till loggfilen (lägger till utdata i den befintliga loggfilen).
/unilog:<logfile> Skriver statusutdata till loggfilen som unicode-text (skriver över den befintliga loggfilen).
/unilog+:<logfile> Skriver statusutdata till loggfilen som Unicode-text (lägger till utdata i den befintliga loggfilen).
/tee Skriver statusutdata till konsolfönstret och till loggfilen.
/njh Anger att det inte finns någon jobbrubrik.
/njs Anger att det inte finns någon jobbsammanfattning.
/unicode Visar statusutdata som unicode-text.

Job options

Option Description
/job:<jobname> Anger att parametrar ska härledas från den namngivna jobbfilen. Om du vill köra /job:jobnamemåste du först köra parametern /save:jobname för att skapa jobbfilen.
/save:<jobname> Anger att parametrar ska sparas i den namngivna jobbfilen. Detta måste köras innan du kör /job:jobname. Alla kopierings-, återförsöks- och loggningsalternativ måste anges före den här parametern.
/quit Avslutas efter bearbetning av kommandoraden (för att visa parametrar).
/nosd Anger att ingen källkatalog har angetts.
/nodd Anger att ingen målkatalog har angetts.
/if Innehåller de angivna filerna.

Remarks

  • Användning av /PURGE eller /MIR i rotkatalogen för volymen ledde tidigare till att robocopy även tillämpade den begärda åtgärden på filer i katalogen System Volume Information. Detta är inte längre fallet som om någon av dem har angetts, robocopy hoppar över filer eller kataloger med det namnet i den översta käll- och målkatalogen för kopieringssessionen.

  • Klassificering av ändrade filer gäller endast när både käll- och målfilsystem stöder ändringstidsstämplar, till exempel NTFS, och käll- och målfilerna har olika ändringstider men i övrigt är desamma. Dessa filer kopieras inte som standard. Ange /IM för att inkludera dem.

  • Flaggan /DCOPY:E begär att utökad attributkopiering ska göras för kataloger. Robocopy fortsätter kopieringsåtgärden även om det inte gick att kopiera en katalogs serviceavtal. Den här flaggan ingår inte i /COPYALL.

  • Om antingen /IoMaxSize eller /IoRate anges aktiverar robocopy begränsning av kopieringsfiler för att minska systembelastningen. Båda kan justeras till optimala värden och kopieringsparametrar, men systemet och robocopy tillåts justera dem till tillåtna värden efter behov.

  • Om /Threshold används anger den en minsta filstorlek för att aktivera begränsning. Filer under den storleken begränsas inte. Värden för alla tre parametrarna kan följas av ett valfritt suffixtecken, till exempel [KMG] (kilobyte, megabyte, gigabyte).

  • Om du använder /LFSM begär du att robocopy ska fungera i läget "lågt ledigt utrymme". I det här läget pausar robocopy när en filkopia gör att målvolymens lediga utrymme hamnar under värdet "floor". Det här värdet kan uttryckligen anges med hjälp av flaggan /LFSM:n[KMG].

  • Om /LFSM anges utan något explicit golvvärde anges golvet till 10% av målvolymens storlek. Läget för lågt ledigt utrymme är inte kompatibelt med /MT och /EFSRAW.

Avsluta (retur)-koder

Value Description
0 Inga filer kopierades. Inget fel påträffades. Inga filer matchades på fel sätt. Filerna finns redan i målkatalogen. Därför hoppades kopieringsåtgärden över.
1 Alla filer har kopierats.
2 Det finns några ytterligare filer i målkatalogen som inte finns i källkatalogen. Inga filer kopierades.
3 Vissa filer kopierades. Ytterligare filer fanns. Inget fel påträffades.
5 Vissa filer kopierades. Vissa filer matchades inte. Inget fel påträffades.
6 Det finns ytterligare filer och felmatchade filer. Inga filer kopierades och inga fel påträffades, vilket innebär att filerna redan finns i målkatalogen.
7 Filer kopierades, en filmatchningsfel fanns och ytterligare filer fanns.
8 Flera filer kopierade inte.

Note

Alla värden som är lika med eller större än 8 anger att det uppstod minst ett fel under kopieringen.

Examples

Vi rekommenderar starkt att du kör kommandot robocopy för att skapa en loggfil som kan visas när processen är klar och verifierar dess integritet. I följande exempel använder var och en parametern /LOG:. Om du vill lägga till logginformation i samma loggfil använder du parametern /LOG+: i stället.

Om du vill kopiera alla filer och underkataloger, inklusive tomma kataloger, från mappen "Records" till mappen "Backup" på enheten "D", skriver du:

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

Om du vill spegla innehållet i mappen "Records" till mappen "Backup" på enhet "D" tar du bort alla filer i målet som inte finns i källan med 2 återförsök och väntar 5 sekunder mellan varje nytt försök genom att skriva:

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

Om du vill kopiera alla filer och underkataloger som inte är tomma från mappen "Records" till mappen "Backup" på enheten "D", och behålla fildata, attribut och tidsstämplar med 16 kopieringsåtgärd med flera trådar skriver du:

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

Om du vill flytta filer och underkataloger, exklusive tomma kataloger, från mappen "Records" till mappen "Backup" på enheten "D", och exkludera filer som är äldre än 7 dagar, skriver du:

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

Om du vill kopiera alla filer och underkataloger, inklusive tomma kataloger, från mappen "Records" till mappen "Backup" på enhet "D" som visar den uppskattade tiden för varje fil och tar bort filer och kataloger i målet som inte finns från källan skriver du:

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

Om du vill kopiera alla filer och underkataloger från mappen med namnet "Records" på C-enheten till en mapp med namnet "Backup" på "D"-enheten samtidigt som I/O-hastigheten begränsas till 1 megabyte per sekund under kopieringsåtgärden skriver du:

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

Om du vill hoppa över att kopiera filer från en källmapp till en målmapp när filerna redan finns i målmappen, oavsett om de är nyare, äldre eller ändrade, skriver du:

robocopy C:\Source C:\Destination /XC /XN /XO