Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Kopieert bestandsgegevens van de ene locatie naar de andere.
Syntax
robocopy <source> <destination> [<file>[ ...]] [<options>]
Als u bijvoorbeeld een bestand met de naam yearly-report.mov wilt kopiëren van c:\rnaar een bestandsshare \\marketing\videos terwijl multi-threading is ingeschakeld voor betere prestaties (met de parameter /mt ) en de mogelijkheid om de overdracht opnieuw te starten in het geval deze wordt onderbroken (met de parameter /z ), typt u:
robocopy c:\reports "\\marketing\videos" yearly-report.mov /mt /z
Important
Als er gegevens worden gekopieerd uit de root van een apparaat, neemt de doelmap tijdens het kopieerproces de kenmerken "verborgen" en "systeem" over.
Parameters
| Parameter | Description |
|---|---|
<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 opties voor kopiëren, bestand, opnieuw proberen, logboekregistratie en taken . |
Copy options
| Option | Description |
|---|---|
| /s | Copies subdirectories. Met deze optie worden automatisch lege mappen uitgesloten. |
| /e | Copies subdirectories. Deze optie bevat automatisch lege mappen. |
/lev:<n> |
Kopieert alleen de bovenste n niveaus van de bronmappenstructuur. |
| /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:
|
| /sec | Kopieert bestanden met beveiliging (gelijk aan /copy:DATS). |
| /copyall | Kopieert alle bestandsinformatie (gelijk aan /copy:DATSOU). |
| /nocopy | Kopieert geen bestandsinformatie (handig met /purge). |
| /secfix | Lost de bestandsbeveiliging op alle bestanden op, zelfs overgeslagen bestanden. |
| /timfix | Corrigeert bestandstijden voor alle bestanden, zelfs overgeslagen bestanden. |
| /purge | 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, worden de beveiligingsinstellingen van de doelmap niet overschreven. |
| /mir | Spiegelt een mappenstructuur (gelijk 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. |
| /move | 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:
|
| /create | Hiermee maakt u alleen een mapstructuur en bestanden met lengte nul. |
| /fat | 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> |
Bewaakt de bron en wordt opnieuw uitgevoerd wanneer er meer dan n wijzigingen worden gedetecteerd. |
/mot:<m> |
Bewaakt de bron en wordt in m minuten opnieuw uitgevoerd als er veranderingen 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> |
Maakt multi-threaded kopieën met n threads.
n moet een geheel getal zijn tussen 1 en 128. De standaardwaarde voor n is 8. Voor betere prestaties kunt u uw uitvoer omleiden met de / log-optie . De parameter /mt kan niet worden gebruikt met de parameters /ipg en /efsraw . |
| /nodcopy | Kopieert geen directory info (de standaard /dcopy:DA is klaar). |
| /nooffload | Kopieert bestanden zonder het Windows Copy Offload-mechanisme te gebruiken. |
| /compress | 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, staat deze standaard op ja (ingeschakeld). |
| /noclone | Het klonen wordt niet als optimalisatie geprobeerd. |
Important
Wanneer u de kopieeroptie /secfix gebruikt, geeft u het type beveiligingsinformatie op dat u wilt kopiëren, met behulp van een van deze extra kopieeropties:
- /copyall
- /copy:o
- /copy:s
- /copy:u
- /sec
Note
De parameter /mt is geïntroduceerd in Windows Server 2008 R2 en de functionaliteit ervan is van toepassing op de huidige versies van Windows Server.
Opties voor bestandsbeperking kopiëren
| Option | Description |
|---|---|
/iomaxsize:<n>[kmg] |
De gevraagde maximale i/o-grootte per lees-/schrijfcyclus in nkilobytes, megabytes of gigabytes. |
/iorate:<n>[kmg] |
De gevraagde i/o-snelheid in nkilobytes megabytes, of gigabytes per seconde. |
/threshold:<n>[kmg] |
De drempelwaarde voor de 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 dit niet is opgegeven in bytes per seconde, kunnen hele getallen worden gebruikt als k, m of g zijn opgegeven. De minimale I/O-bandbreedte die wordt beperkt, is 524288 bytes, zelfs als een lagere waarde is opgegeven.
Opties voor bestandsselectie
| Option | Description |
|---|---|
| /a | Kopieert alleen bestanden 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. |
| /it | Bevat 'aangepaste' bestanden. Aangepaste bestanden hebben dezelfde naam, grootte en tijden, maar verschillende kenmerken. |
/max:<n> |
Hiermee geeft u de maximale bestandsgrootte op (om bestanden groter dan n bytes uit te sluiten). |
/min:<n> |
Hiermee geeft u de minimale bestandsgrootte op (om bestanden kleiner dan n bytes uit te sluiten). |
/maxage:<n> |
Hiermee geeft u de maximale bestandsleeftijd op om bestanden uit te sluiten die ouder zijn dan n dagen of een datum op basis van wanneer de bestanden voor het laatst zijn gewijzigd. |
/minage:<n> |
Hiermee geeft u de minimale bestandsleeftijd op om bestanden uit te sluiten die nieuwer zijn dan n dagen of een datum op basis van wanneer de bestanden voor het laatst zijn gewijzigd. |
/maxlad:<n> |
Hiermee geeft u de maximale laatste toegangsdatum op (exclusief bestanden die sinds n niet meer zijn gebruikt). |
/minlad:<n> |
Hiermee geeft u de minimale laatste toegangsdatum op (exclusief bestanden die sinds n zijn gebruikt) Als n kleiner is dan 1900, geeft n het aantal dagen aan. 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. |
Retry options
| Option | Description |
|---|---|
/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 | Slaat de waarden op die zijn opgegeven in de opties /r en /w als standaardinstellingen in het register. |
| /tbd | Hiermee geeft u op dat het systeem wacht tot sharenamen zijn gedefinieerd (fout 67 opnieuw proberen). |
| /lfsm | Werk in de modus met weinig vrije ruimte die kopiëren, pauzeren en hervatten mogelijk maakt (zie Opmerkingen). |
/lfsm:<n>[kmg] |
Hiermee geeft u de vloergrootte op in nkilobytes, megabytes of gigabytes. |
Logging options
| Option | Description |
|---|---|
| /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). |
| /eta | 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. |
Job options
| Option | Description |
|---|---|
/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. |
| /quit | Wordt afgesloten na het verwerken van de opdrachtregel (om parameters weer te geven). |
| /nosd | Geeft aan dat er geen bronmap is opgegeven. |
| /nodd | Geeft aan dat er geen doelmap is opgegeven. |
| /if | Bevat de opgegeven bestanden. |
Remarks
Het gebruik van /PURGE of /MIR op de hoofdmap van het volume zorgde er voorheen voor dat robocopy de gevraagde bewerking ook toepaste op bestanden in de map Systeemvolume-informatie. 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. Specificeer /IM om ze op te nemen.
De /DCOPY:E-vlag vraagt om uitgebreid attributen te kopiëren 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 is opgegeven, maakt robocopy beperking van kopieerbestanden mogelijk 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, wordt een minimale bestandsgrootte opgegeven 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).
Het gebruik van /LFSM vraagt robocopy om te werken in 'modus voor 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 de vlag /LFSM:n[KMG].
Als /LFSM is opgegeven zonder expliciete verdiepingswaarde, wordt de verdieping ingesteld op 10% van de grootte van het doelvolume. De modus voor weinig vrije ruimte is niet compatibel met /MT en /EFSRAW.
Afsluitcodes (retourcodes)
| Value | Description |
|---|---|
| 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. |
Note
Elke waarde gelijk aan of groter dan 8 geeft aan dat er ten minste één fout is opgetreden tijdens de kopieerbewerking.
Examples
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