robocopy
Kopieert bestandsgegevens van de ene locatie naar de andere.
Syntaxis
robocopy <source> <destination> [<file>[ ...]] [<options>]
Als u bijvoorbeeld een bestand met de naam yearly-report.mov wilt kopiëren van c:\reporteert naar een bestandsshare \\marketing\video's terwijl u multithreading inschakelt voor hogere prestaties (met de parameter /mt) en de mogelijkheid om de overdracht opnieuw op te starten voor het geval deze wordt onderbroken (met de parameter /z), typt u:
robocopy c:\reports "\\marketing\videos" yearly-report.mov /mt /z
Belangrijk
Als er gegevens worden gekopieerd uit de root van een apparaat, worden tijdens het kopieerproces de kenmerken 'verborgen' en 'systeem' in de doelmap gebruikt.
Parameters
| Parameter | Beschrijving |
|---|---|
<source> |
Hiermee geeft u het pad naar de bronmap. |
<destination> |
Hiermee geeft u het pad naar de doelmap. |
<file> |
Hiermee geeft u het bestand of de bestanden die moeten worden gekopieerd. Jokertekens (* of ?) worden ondersteund. Als u deze parameter niet opgeeft, wordt *.* gebruikt als de standaardwaarde. |
<options> |
Hiermee geeft u de opties op die moeten worden gebruikt met de robocopy opdracht, waaronder kopiëren, bestand, opnieuw, logboekregistratieen taak opties. |
Kopieeropties
| Optie | Beschrijving |
|---|---|
| /s | Kopieert submappen. Met deze optie worden automatisch lege mappen uitgesloten. |
| /e | Kopieert submappen. Deze optie bevat automatisch lege mappen. |
/lev:<n> |
Kopieert alleen de bovenste n niveaus van de bronmapstructuur. |
| /z | Kopieert bestanden in de modus voor opnieuw opstarten. Als een bestandskopie in de herstartbare modus wordt onderbroken, kan Robocopy de locatie ophalen waar het was gebleven in plaats van het hele bestand opnieuw te kopiëren. |
| /b | Kopieert bestanden in de back-upmodus. In de back-upmodus overschrijft Robocopy de instellingen voor bestands- en mapmachtigingen (ACL's), die anders de toegang kunnen blokkeren. |
| /zb | Kopieert bestanden in de modus voor opnieuw opstarten. Als bestandstoegang wordt geweigerd, schakelt u over naar de back-upmodus. |
| /j | Kopieën met niet-gebufferde I/O (aanbevolen voor grote bestanden). |
| /efsraw | Kopieert alle versleutelde bestanden in de EFS RAW-modus. |
/copy:<copyflags> |
Hiermee geeft u op welke bestandseigenschappen moeten worden gekopieerd. De geldige waarden voor deze optie zijn:
|
/dcopy:<copyflags> |
Hiermee geeft u op wat moet worden gekopieerd in mappen. De geldige waarden voor deze optie zijn:
|
| /seconde | Kopieert bestanden met beveiliging (equivalent aan /copy:DATS). |
| /copyall | Alle bestandsgegevens worden gekopieerd (gelijk aan /copy:DATSOU). |
| /nocopy | Kopieert geen bestandsinformatie (handig bij /purge). |
| /secfix | Lost de bestandsbeveiliging op alle bestanden op, zelfs overgeslagen bestanden. |
| /timfix | Corrigeert bestandstijden voor alle bestanden, zelfs overgeslagen bestanden. |
| /zuiveren | Hiermee verwijdert u doelbestanden en mappen die niet meer in de bron aanwezig zijn. Als u deze optie gebruikt met de optie /e en een doelmap, kunnen de beveiligingsinstellingen van de doelmap niet worden overschreven. |
| /Mir | Spiegelt een mapstructuur (equivalent aan /e plus /purge). Als u deze optie gebruikt met de optie /e en een doelmap, worden de beveiligingsinstellingen van de doelmap overschreven. |
| /Mov | Bestanden worden verplaatst en verwijderd uit de bron nadat ze zijn gekopieerd. |
| /bewegen | Hiermee verplaatst u bestanden en mappen en verwijdert u ze uit de bron nadat ze zijn gekopieerd. |
| /a+:[RASHCNET] | Voegt de opgegeven kenmerken toe aan gekopieerde bestanden. De geldige waarden voor deze optie zijn:
|
| /a-:[RASHCNETO] | Hiermee verwijdert u de opgegeven kenmerken uit gekopieerde bestanden. De geldige waarden voor deze optie zijn:
|
| /scheppen | Hiermee maakt u alleen een mapstructuur en bestanden met lengte nul. |
| /vet | Hiermee maakt u doelbestanden met alleen 8,3 tekenlengte FAT-bestandsnamen. |
| /256 | Hiermee wordt ondersteuning uitgeschakeld voor paden die langer zijn dan 256 tekens. |
/mon:<n> |
Controleert de bron en wordt opnieuw uitgevoerd wanneer er meer dan n wijzigingen worden gedetecteerd. |
/mot:<m> |
Controleert de bron en wordt opnieuw uitgevoerd in m minuten als er wijzigingen worden gedetecteerd. |
| /rh:hhmm-hhmm | Hiermee geeft u uitvoeringstijden op waarop nieuwe kopieën kunnen worden gestart. |
| /Pf | Controleert uitvoeringstijden per bestand (niet per pass). |
/ipg:<n> |
Hiermee geeft u de tussenruimte tussen pakketten op vrije bandbreedte op trage lijnen. |
| /Sj | Kopieert verbindingen (soft-links) naar het doelpad in plaats van koppelingsdoelen. |
| /Sl | Volg geen symbolische koppelingen en maak in plaats daarvan een kopie van de koppeling. |
/mt:<n> |
Hiermee maakt u kopieën met meerdere threads met n threads.
n moet een geheel getal tussen 1 en 128 zijn. De standaardwaarde voor n is 8. Voor betere prestaties kunt u de uitvoer omleiden met optie /log. De parameter /mt kan niet worden gebruikt met de parameters /ipg en /efsraw. |
| /nodcopy | Kopieert geen mapgegevens (de standaard-/dcopy:DA is voltooid). |
| /nooffload | Kopieert bestanden zonder het Windows Copy Offload-mechanisme te gebruiken. |
| /comprimeren | Vraagt netwerkcompressie aan tijdens bestandsoverdracht, indien van toepassing. |
/sparse:<y|n> |
Hiermee wordt de sparsestatus van bestanden tijdens het kopieerproces ingeschakeld of uitgeschakeld. Als er geen optie is geselecteerd, wordt deze standaard ingesteld op ja (ingeschakeld). |
| /noclone | Het klonen wordt niet als optimalisatie geprobeerd. |
Belangrijk
Wanneer u de optie /secfix kopieeroptie gebruikt, geeft u het type beveiligingsgegevens op dat u wilt kopiëren met behulp van een van de volgende extra kopieeropties:
- /copyall-
- /copy:o
- /copy:s
- /copy:u
- per seconde
Notitie
De parameter /mt is geïntroduceerd in Windows Server 2008 R2 en de functionaliteit is van toepassing op de huidige versies van Windows Server.
Opties voor bestandsbeperking kopiëren
| Optie | Beschrijving |
|---|---|
/iomaxsize:<n>[kmg] |
De aangevraagde maximale i/o-grootte per lees-/schrijfcyclus in nkilobytes, megabytes of gigabytes. |
/iorate:<n>[kmg] |
De aangevraagde i/o-snelheid in nkilobytes megabytes of gigabytes per seconde. |
/threshold:<n>[kmg] |
De drempelwaarde voor bestandsgrootte voor beperking in nkilobytes, megabytes of gigabytes (zie Opmerkingen). |
Deze beperkingsopties worden gebruikt om de maximale I/O-bandbreedte op te geven waarmee Robocopy kan worden gebruikt in bytes per seconde. Als u geen bytes per seconde opgeeft, kunnen gehele getallen worden gebruikt als k, mof g worden opgegeven. De minimale I/O-bandbreedte die wordt beperkt, is 524288 bytes, zelfs als er een lagere waarde is opgegeven.
Opties voor bestandsselectie
| Optie | Beschrijving |
|---|---|
| /een | Hiermee worden alleen bestanden gekopieerd waarvoor het kenmerk Archief is ingesteld. |
| /m | Kopieert alleen bestanden waarvoor het kenmerk Archief is ingesteld en stelt het kenmerk Archief opnieuw in. |
/ia:[RASHCNETO] |
Bevat alleen bestanden waarvoor een van de opgegeven kenmerken is ingesteld. De geldige waarden voor deze optie zijn:
|
/xa:[RASHCNETO] |
Sluit bestanden uit waarvoor een van de opgegeven kenmerken is ingesteld. De geldige waarden voor deze optie zijn:
|
/xf-<filename>[ ...] |
Sluit bestanden uit die overeenkomen met de opgegeven namen of paden. Jokertekens (* en ?) worden ondersteund. |
/xd-<directory>[ ...] |
Hiermee worden mappen uitgesloten die overeenkomen met de opgegeven namen en paden. |
| /Xc | Sluit bestaande bestanden met dezelfde tijdstempel, maar verschillende bestandsgrootten uit. |
| /Xn | Bronmapbestanden die hoger zijn dan de bestemming, worden uitgesloten van de kopie. |
| /Xo | Bronmapbestanden die ouder zijn dan de bestemming, worden uitgesloten van de kopie. |
| /Xx | Hiermee worden extra bestanden en mappen uitgesloten die aanwezig zijn in de bestemming, maar niet in de bron. Als u geen extra bestanden uitsluit, worden bestanden niet van de bestemming verwijderd. |
| /Xl | Sluit 'eenzame' bestanden en mappen uit die aanwezig zijn in de bron, maar niet in de bestemming. Als u eenzame bestanden uitsluit, voorkomt u dat nieuwe bestanden aan de bestemming worden toegevoegd. |
| /im | Aangepaste bestanden opnemen (verschillende wijzigingstijden). |
| /is | Bevat dezelfde bestanden. Dezelfde bestanden zijn identiek in naam, grootte, tijden en alle kenmerken. |
| /het | Bevat 'aangepaste' bestanden. Aangepaste bestanden hebben dezelfde naam, grootte en tijden, maar verschillende kenmerken. |
/max:<n> |
Hiermee geeft u de maximale bestandsgrootte (om bestanden uit te sluiten die groter zijn dan n bytes). |
/min:<n> |
Hiermee geeft u de minimale bestandsgrootte (om bestanden uit te sluiten die kleiner zijn dan n bytes). |
/maxage:<n> |
Hiermee geeft u de maximale bestandsgrootte voor het uitsluiten van bestanden ouder dan n dagen of een datum op basis van wanneer de bestanden voor het laatst zijn gewijzigd. |
/minage:<n> |
Hiermee geeft u de minimale bestandsgrootte voor het uitsluiten van bestanden nieuwer dan n dagen of een datum op basis van wanneer de bestanden voor het laatst zijn gewijzigd. |
/maxlad:<n> |
Hiermee geeft u de maximale datum van laatste toegang (bestanden die niet worden gebruikt sinds n). |
/minlad:<n> |
Hiermee geeft u de minimale datum van laatste toegang (sluit bestanden uit die worden gebruikt sinds n) Als n kleiner is dan 1900, geeft n het aantal dagen op. Anders geeft n een datum op in de notatie JJJJMMDD. |
| /xj | Sluit verbindingspunten uit, die normaal gesproken standaard zijn opgenomen. |
| /Fft | Gaat uit van FAT-bestandstijden (precisie van twee seconden). |
| /Dst | Compenseert verschillen in de DST-tijd van één uur. |
| /xjd | Sluit verbindingspunten voor directory's uit. |
| /xjf | Sluit verbindingspunten voor bestanden uit. |
Opties voor opnieuw proberen
| Optie | Beschrijving |
|---|---|
/r:<n> |
Hiermee geeft u het aantal nieuwe pogingen op mislukte kopieën. De standaardwaarde van n is 1.000.000 (één miljoen nieuwe pogingen). |
/w:<n> |
Hiermee geeft u de wachttijd tussen nieuwe pogingen, in seconden. De standaardwaarde van n is 30 (wachttijd 30 seconden). |
| /Reg | Hiermee worden de waarden opgeslagen die zijn opgegeven in de /r- en /w opties als standaardinstellingen in het register. |
| /Tbd | Hiermee geeft u op dat het systeem wacht tot sharenamen zijn gedefinieerd (fout 67 opnieuw proberen). |
| /lfsm | Werken in de modus met weinig vrije ruimte waarmee u kunt kopiëren, onderbreken en hervatten (zie Opmerkingen). |
/lfsm:<n>[kmg] |
Hiermee geeft u de vloergrootte in nkiilobytes, megabytes of gigabytes. |
Opties voor logboekregistratie
| Optie | Beschrijving |
|---|---|
| /l | Hiermee geeft u op dat bestanden alleen worden weergegeven (en niet gekopieerd, verwijderd of tijdstempel). |
| /x | Rapporteert alle extra bestanden, niet alleen de bestanden die zijn geselecteerd. |
| /v | Produceert uitgebreide uitvoer en toont alle overgeslagen bestanden. |
| /Ts | Bevat tijdstempels voor bronbestanden in de uitvoer. |
| /Fp | Bevat de volledige padnamen van de bestanden in de uitvoer. |
| /Bytes | Hiermee worden de grootten afgedrukt als bytes. |
| /Ns | Hiermee geeft u op dat de bestandsgrootten niet moeten worden vastgelegd. |
| /Nc | Hiermee geeft u op dat bestandsklassen niet moeten worden vastgelegd. |
| /Nfl | Hiermee geeft u op dat bestandsnamen niet moeten worden vastgelegd. |
| /ndl | Hiermee geeft u op dat mapnamen niet moeten worden geregistreerd. |
| /Np | Hiermee geeft u de voortgang van de kopieerbewerking niet weer (het aantal bestanden of mappen dat tot nu toe is gekopieerd). |
| /èta | Toont de geschatte tijd van aankomst (ETA) van de gekopieerde bestanden. |
/log:<logfile> |
Schrijft de statusuitvoer naar het logboekbestand (overschrijft het bestaande logboekbestand). |
/log+:<logfile> |
Hiermee schrijft u de statusuitvoer naar het logboekbestand (voegt de uitvoer toe aan het bestaande logboekbestand). |
/unilog:<logfile> |
Schrijft de statusuitvoer naar het logboekbestand als Unicode-tekst (overschrijft het bestaande logboekbestand). |
/unilog+:<logfile> |
Hiermee schrijft u de statusuitvoer naar het logboekbestand als Unicode-tekst (voegt de uitvoer toe aan het bestaande logboekbestand). |
| /Tee | Hiermee schrijft u de statusuitvoer naar het consolevenster en naar het logboekbestand. |
| /njh | Hiermee geeft u op dat er geen taakheader is. |
| /njs | Hiermee geeft u op dat er geen taakoverzicht is. |
| /Unicode | Geeft de statusuitvoer weer als Unicode-tekst. |
Taakopties
| Optie | Beschrijving |
|---|---|
/job:<jobname> |
Hiermee geeft u op dat parameters moeten worden afgeleid van het benoemde taakbestand. Als u /job:jobnamewilt uitvoeren, moet u eerst de parameter /save:jobname uitvoeren om het taakbestand te maken. |
/save:<jobname> |
Hiermee geeft u op dat parameters moeten worden opgeslagen in het benoemde taakbestand. Dit moet worden uitgevoerd voordat /job:jobnamewordt uitgevoerd. Alle opties voor kopiëren, opnieuw proberen en logboekregistratie moeten vóór deze parameter worden opgegeven. |
| /verlaten | Wordt afgesloten na het verwerken van de opdrachtregel (om parameters weer te geven). |
| /nosd | Geeft aan dat er geen bronmap is opgegeven. |
| /nod | Geeft aan dat er geen doelmap is opgegeven. |
| /als | Bevat de opgegeven bestanden. |
Opmerkingen
Als u /PURGE of /MIR gebruikt in de hoofdmap van het volume, heeft Robocopy de aangevraagde bewerking ook toegepast op bestanden in de map Systeemvolumegegevens. Dit is niet langer het geval alsof een van beide is opgegeven, robocopy slaat bestanden of mappen met die naam over in de bron- en doelmappen op het hoogste niveau van de kopieersessie.
Gewijzigde bestandsclassificatie is alleen van toepassing wanneer zowel bron- als doelbestandssystemen wijzigingstijdenstempels ondersteunen, zoals NTFS, en de bron- en doelbestanden verschillende wijzigingstijden hebben, maar anders hetzelfde zijn. Deze bestanden worden niet standaard gekopieerd. Geef /IM- op om ze op te nemen.
De /DCOPY:E vlag vraagt dat uitgebreide kenmerk kopiëren moet worden uitgevoerd voor mappen. Robocopy zet de kopieerbewerking voort, zelfs als de EA's van een map niet kunnen worden gekopieerd. Deze vlag is niet opgenomen in /COPYALL-.
Als /IoMaxSize- of /IoRate- zijn opgegeven, schakelt Robocopy het kopiëren van bestandsbeperking in om de systeembelasting te verminderen. Beide kunnen worden aangepast aan optimale waarden en kopieerparameters, maar het systeem en robocopy kunnen ze indien nodig aanpassen aan toegestane waarden.
Als /Threshold wordt gebruikt, geeft deze een minimale bestandsgrootte op voor het inschakelen van beperking. Bestanden onder die grootte worden niet beperkt. Waarden voor alle drie parameters kunnen worden gevolgd door een optioneel achtervoegselteken zoals [KMG] (kilobytes, megabytes, gigabytes).
Met behulp van /LFSM vraagt robocopy om te werken in de 'modus weinig vrije ruimte'. In deze modus pauzeert Robocopy wanneer een bestandskopie ertoe zou leiden dat de vrije ruimte van het doelvolume onder de waarde 'floor' komt te zitten. Deze waarde kan expliciet worden opgegeven met behulp van /LFSM:n[KMG]-vlag.
Als /LFSM- wordt opgegeven zonder expliciete vloerwaarde, wordt de vloer ingesteld op 10% van de grootte van het doelvolume. De vrije ruimtemodus is niet compatibel met /MT- en /EFSRAW-.
Afsluitcodes (retourcodes)
| Waarde | Beschrijving |
|---|---|
| 0 | Er zijn geen bestanden gekopieerd. Er is geen fout opgetreden. Er zijn geen bestanden die niet overeenkomen. De bestanden bestaan al in de doelmap; daarom is de kopieerbewerking overgeslagen. |
| 1 | Alle bestanden zijn gekopieerd. |
| 2 | Er zijn enkele extra bestanden in de doelmap die niet aanwezig zijn in de bronmap. Er zijn geen bestanden gekopieerd. |
| 3 | Sommige bestanden zijn gekopieerd. Er waren extra bestanden aanwezig. Er is geen fout opgetreden. |
| 5 | Sommige bestanden zijn gekopieerd. Sommige bestanden komen niet overeen. Er is geen fout opgetreden. |
| 6 | Er bestaan extra bestanden en niet-overeenkomende bestanden. Er zijn geen bestanden gekopieerd en er zijn geen fouten opgetreden, wat betekent dat de bestanden al bestaan in de doelmap. |
| 7 | Bestanden zijn gekopieerd, een bestand komt niet overeen en er zijn extra bestanden aanwezig. |
| 8 | Verschillende bestanden zijn niet gekopieerd. |
Notitie
Elke waarde die gelijk is aan of groter is dan 8 geeft aan dat er ten minste één fout is opgetreden tijdens de kopieerbewerking.
Voorbeelden
Het wordt ten zeerste aanbevolen bij het uitvoeren van de opdracht robocopy om een logboekbestand te maken dat kan worden weergegeven zodra het proces is voltooid om de integriteit ervan te controleren. In de volgende voorbeelden gebruikt elk de parameter /LOG:. Als u logboekgegevens wilt toevoegen aan hetzelfde logboekbestand, gebruikt u in plaats daarvan de parameter /LOG+:.
Als u alle bestanden en submappen, inclusief lege mappen, wilt kopiëren van de map Records naar de map Back-up op station D, typt u:
robocopy C:\Users\Admin\Records D:\Backup /E /ZB /LOG:C:\Logs\Backup.log
Als u de inhoud van de map 'Records' wilt spiegelen naar de map 'Back-up' op station D, verwijdert u alle bestanden in het doel dat niet in de bron bestaat met 2 nieuwe pogingen en wacht u 5 seconden tussen elke nieuwe poging, typt u:
robocopy C:\Users\Admin\Records D:\Backup /MIR /R:2 /W:5 /LOG:C:\Logs\Backup.log
Als u alle bestanden en submappen wilt kopiëren die niet leeg zijn uit de map 'Records' naar de map 'Back-up' op station D, blijven de bestandsgegevens, kenmerken en tijdstempels behouden met 16 kopieerbewerkingen met meerdere threads, typt u:
robocopy C:\Users\Admin\Records D:\Backup /S /E /COPY:DAT /MT:16 /LOG:C:\Logs\Backup.log
Als u bestanden en submappen wilt verplaatsen, met uitzondering van lege mappen, van de map Records naar de map Back-up op station D en bestanden die ouder zijn dan 7 dagen, typt u:
robocopy C:\Users\Admin\Records D:\Backup /S /MAXAGE:7 /MOV /LOG:C:\Logs\Backup.log
Als u alle bestanden en submappen, inclusief lege mappen, wilt kopiëren van de map 'Records' naar de map 'Back-up' op station D, met de geschatte tijd voor elk bestand en alle bestanden en mappen verwijderen in de bestemming die niet uit de bron bestaan, typt u:
robocopy C:\Users\Admin\Records D:\Backup /ETA /PURGE /LOG:C:\Logs\Backup.log
Als u alle bestanden en submappen wilt kopiëren van de map met de naam 'Records' op het station C naar een map met de naam 'Back-up' op het station D terwijl de I/O-snelheid wordt beperkt tot 1 megabyte per seconde tijdens de kopieerbewerking, typt u:
robocopy C:\Records D:\Backup /iorate:1m
Als u het kopiëren van bestanden uit een bronmap naar een doelmap wilt overslaan wanneer de bestanden al in de doelmap staan, ongeacht of ze nieuwer, ouder of gewijzigd zijn, typt u:
robocopy C:\Source C:\Destination /XC /XN /XO