AzCopy v10-configuratie-instellingen (Azure Storage)
AzCopy is een opdrachtregelprogramma dat u kunt gebruiken om blobs of bestanden te kopiëren vanuit of naar een opslagaccount. Dit artikel bevat een lijst met omgevingsvariabelen die u kunt gebruiken om AzCopy v10 te configureren.
Notitie
Als u inhoud zoekt om aan de slag te gaan met AzCopy, raadpleegt u Aan de slag met AzCopy.
AzCopy v10-omgevingsvariabelen
De volgende tabel beschrijft elke omgevingsvariabele en bevat koppelingen naar inhoud waarmee u de variabele kunt gebruiken.
| Omgevingsvariabele | Beschrijving |
|---|---|
| AWS_ACCESS_KEY_ID | Amazon Web Services-toegangssleutel. Biedt een sleutel om te autoriseren met Amazon Web Services.Gegevens kopiëren van Amazon S3 naar Azure Storage met behulp van AzCopy |
| AWS_SECRET_ACCESS_KEY | Amazon Web Services geheime toegangssleutel biedt een geheime sleutel om te autoriseren met Amazon Web Services. Gegevens kopiëren van Amazon S3 naar Azure Storage met behulp van AzCopy |
| AZCOPY_ACTIVE_DIRECTORY_ENDPOINT | Het Microsoft Entra-eindpunt dat moet worden gebruikt. Deze variabele wordt alleen gebruikt voor automatische aanmelding. Gebruik in plaats daarvan de opdrachtregelvlag wanneer u de aanmeldingsopdracht aanroept. |
| AZCOPY_AUTO_LOGIN_TYPE | Stel deze variabele in op DEVICE, MSI, SPN, en AZCLI.PSCRED Deze variabele biedt de mogelijkheid om te autoriseren zonder de azcopy login opdracht te gebruiken. Zie Toegang tot blobs autoriseren met AzCopy en Microsoft Entra-id. |
| AZCOPY_BUFFER_GB | Geef de maximale hoeveelheid systeemgeheugen op die AzCopy moet gebruiken bij het downloaden en uploaden van bestanden. Geef deze waarde op in gigabytes (GB). Zie Geheugengebruik optimaliseren |
| AZCOPY_CACHE_PROXY_LOOKUP | Standaard slaat AzCopy in Windows proxyserverzoekacties op hostnaamniveau op in de cache (waarbij geen rekening wordt gehouden met het URL-pad). Stel deze waarde in op een andere waarde dan 'true' om de cache uit te schakelen. |
| AZCOPY_CONCURRENCY_VALUE | Hiermee geeft u het aantal gelijktijdige aanvragen op dat kan optreden. U kunt deze variabele gebruiken om de doorvoer te verhogen. Als uw computer minder dan 5 CPU's heeft, wordt de waarde van deze variabele ingesteld op 32. Anders is de standaardwaarde gelijk aan 16 vermenigvuldigd met het aantal CPU's. De maximale standaardwaarde van deze variabele is 3000, maar u kunt deze waarde handmatig hoger of lager instellen. Zie Gelijktijdigheid verhogen |
| AZCOPY_CONCURRENT_FILES | Overschrijft het (geschatte) aantal bestanden dat op elk moment wordt uitgevoerd door te bepalen hoeveel bestanden we gelijktijdig overdrachten starten. |
| AZCOPY_CONCURRENT_SCAN | Bepaalt de (max) mate van parallelle uitvoering die tijdens het scannen wordt gebruikt. Alleen van invloed op geparallelliseerde enumerators, waaronder Azure Files/Blobs en lokale bestandssystemen. |
| AZCOPY_CONTENT_TYPE_MAP | Overschrijft een of meer van de standaard MIME-typetoewijzingen die zijn gedefinieerd door uw besturingssysteem. Stel deze variabele in op het pad van een JSON-bestand dat een toewijzing definieert. Hier volgt de inhoud van een voorbeeld-JSON-bestand: { "MIMETypeMapping": { ".323": "text/h323", ".aaf": "application/octet-stream", ".aca": "application/octet-stream", ".accdb": "application/msaccess" } } |
| AZCOPY_DEFAULT_SERVICE_API_VERSION | Hiermee wordt de service-API-versie overschreven, zodat AzCopy geschikt kan zijn voor aangepaste omgevingen zoals Azure Stack. |
| AZCOPY_DISABLE_HIERARCHICAL_SCAN | Is alleen van toepassing wanneer Azure Blobs de bron is. Gelijktijdig scannen is sneller, maar maakt gebruik van de hiërarchische API, wat kan leiden tot meer IOs/kosten. Geef 'true' op om prestaties op te offeren, maar bespaar op kosten. |
| AZCOPY_DISABLE_SYSLOG | Hiermee schakelt u logboekregistratie in Syslog of de Windows-gebeurtenislogboekregistratie uit. Standaard verzendt AzCopy logboeken naar deze kanalen. U kunt deze variabele instellen op true als u de ruis in Syslog of het Windows-gebeurtenislogboek wilt verminderen. |
| AZCOPY_DOWNLOAD_TO_TEMP_PATH | Hiermee configureert u AzCopy om te downloaden naar een tijdelijk pad voordat de werkelijke download wordt uitgevoerd. Toegestane waarden zijn waar of onwaar |
| AZCOPY_JOB_PLAN_LOCATION | Onderdrukkingen waarbij de bestanden van het taakplan (gebruikt voor het bijhouden en hervatten van voortgang) worden opgeslagen om te voorkomen dat een schijf volloopt. |
| AZCOPY_LOG_LOCATION | Overschrijft waar de logboekbestanden worden opgeslagen, om te voorkomen dat een schijf volloopt. |
| AZCOPY_MSI_CLIENT_ID | De client-id van een door de gebruiker toegewezen beheerde identiteit. Gebruik wanneer AZCOPY_AUTO_LOGIN_TYPE is ingesteld op MSI. Zie Autoriseren zonder een geheim archief |
| AZCOPY_MSI_OBJECT_ID | De object-id van de door de gebruiker toegewezen beheerde identiteit. Gebruik wanneer AZCOPY_AUTO_LOGIN_TYPE is ingesteld op MSI. Zie Autoriseren zonder een geheim archief |
| AZCOPY_MSI_RESOURCE_STRING | De resource-id van de door de gebruiker toegewezen beheerde identiteit. Zie Autoriseren zonder een geheim archief |
| AZCOPY_PACE_PAGE_BLOBS | Moet doorvoer voor pagina-blobs automatisch worden aangepast aan servicelimieten? De standaardwaarde is waar. Ingesteld op 'false' om uit te schakelen |
| AZCOPY_PARALLEL_STAT_FILES | Zorgt ervoor dat AzCopy bestandseigenschappen opzoekt op parallelle threads bij het scannen van het lokale bestandssysteem. De threads worden getrokken uit de pool die is gedefinieerd door AZCOPY_CONCURRENT_SCAN. Als u dit instelt op Waar, kunnen de scanprestaties in Linux worden verbeterd. Niet nodig of aanbevolen in Windows. |
| AZCOPY_REQUEST_TRY_TIMEOUT | Stel het aantal minuten in dat AzCopy bestanden voor elke aanvraag moet uploaden voordat er een time-out optreedt voor AzCopy. |
| AZCOPY_SHOW_PERF_STATES | Als deze optie is ingesteld, bevat uitvoer op het scherm het aantal segmenten per status |
| AZCOPY_SPA_APPLICATION_ID | De toepassings-id van de app-registratie van uw service-principal. Gebruik wanneer AZCOPY_AUTO_LOGIN_TYPE is ingesteld op SPN. Zie Autoriseren zonder een geheim archief |
| AZCOPY_SPA_CERT_PASSWORD | Het wachtwoord van een certificaat. Gebruik wanneer AZCOPY_AUTO_LOGIN_TYPE is ingesteld op SPN. Zie Autoriseren zonder een geheim archief |
| AZCOPY_SPA_CERT_PATH | Het relatieve of volledig gekwalificeerde pad naar een certificaatbestand. Gebruik wanneer AZCOPY_AUTO_LOGIN_TYPE is ingesteld op SPN. Zie Autoriseren zonder een geheim archief |
| AZCOPY_SPA_CLIENT_SECRET | Het clientgeheim. Gebruik wanneer AZCOPY_AUTO_LOGIN_TYPE is ingesteld op SPN. Zie Autoriseren zonder een geheim archief |
| AZCOPY_TENANT_ID | De tenant-id van Microsoft Entra voor interactieve aanmelding bij OAuth-apparaten. Deze variabele wordt alleen gebruikt voor automatische aanmelding. Gebruik in plaats daarvan de opdrachtregelvlag wanneer u de aanmeldingsopdracht aanroept. |
| AZCOPY_TUNE_TO_CPU | Ingesteld op onwaar om te voorkomen dat AzCopy rekening houdt met het CPU-gebruik bij het automatisch afstemmen van het gelijktijdigheidsniveau (bijvoorbeeld in de benchmarkopdracht). |
| AZCOPY_USER_AGENT_PREFIX | Voeg een voorvoegsel toe aan de standaard AzCopy-gebruikersagent, die wordt gebruikt voor telemetriedoeleinden. Er wordt automatisch een spatie ingevoegd. |
| CPK_ENCRYPTION_KEY | Een met Base64 gecodeerde AES-256-versleutelingssleutelwaarde. Deze variabele is vereist voor zowel lees- als schrijfaanvragen bij het gebruik van door de klant verstrekte sleutels voor het versleutelen en ontsleutelen van gegevens in Blob Storage-bewerkingen. U kunt door de klant geleverde sleutels gebruiken door de --cpk-by-value=true vlag in te stellen. |
| CPK_ENCRYPTION_KEY_SHA256 | De Base64-gecodeerde SHA256 van de versleutelingssleutel. Deze variabele is vereist voor zowel lees- als schrijfaanvragen bij het gebruik van door de klant verstrekte sleutels voor het versleutelen en ontsleutelen van gegevens in Blob Storage-bewerkingen. U kunt door de klant geleverde sleutels gebruiken door de --cpk-by-value=true vlag in te stellen. |
| GOOGLE_APPLICATION_CREDENTIALS | Het absolute pad naar het sleutelbestand van het serviceaccount biedt een sleutel om te autoriseren met Google Cloud Storage. Gegevens kopiëren van Google Cloud Storage naar Azure Storage met behulp van AzCopy (preview) |
| GOOGLE_CLOUD_PROJECT | Project-id vereist voor traversals op serviceniveau in Google Cloud Storage. |
| HTTPS_PROXY | Hiermee configureert u proxy-instellingen voor AzCopy. Stel deze variabele in op het IP-adres van de proxy en het proxypoortnummer. Bijvoorbeeld xx.xxx.xx.xxx:xx. Als u AzCopy uitvoert in Windows, detecteert AzCopy proxyinstellingen automatisch. U hoeft deze instelling dus niet te gebruiken in Windows. Als u ervoor kiest om deze instelling te gebruiken in Windows, wordt automatische detectie overschreven. Zie Proxy-instellingen configureren |
Proxy-instellingen configureren
Als u de proxy-instellingen voor AzCopy wilt configureren, stelt u de HTTPS_PROXY omgevingsvariabele in. Als u AzCopy uitvoert in Windows, detecteert AzCopy proxyinstellingen automatisch. U hoeft deze instelling dus niet te gebruiken in Windows. Als u ervoor kiest om deze instelling te gebruiken in Windows, wordt automatische detectie overschreven.
| Besturingssysteem | Opdracht |
|---|---|
| Windows | Gebruik in een opdrachtprompt: set HTTPS_PROXY=<proxy IP>:<proxy port>Gebruik in PowerShell: $env:HTTPS_PROXY="<proxy IP>:<proxy port>" |
| Linux | export HTTPS_PROXY=<proxy IP>:<proxy port> |
| MacOS | export HTTPS_PROXY=<proxy IP>:<proxy port> |
Momenteel biedt AzCopy geen ondersteuning voor proxy's waarvoor verificatie met NTLM of Kerberos is vereist.
Een proxy omzeilen
Als u AzCopy uitvoert in Windows en u wilt aangeven dat er helemaal geen proxy wordt gebruikt (in plaats van de instellingen automatisch te detecteren) gebruikt u deze opdrachten. Met deze instellingen zal AzCopy geen proxy opzoeken of proberen te gebruiken.
| Besturingssysteem | Omgeving | Opdrachten |
|---|---|---|
| Windows | Opdrachtprompt (CMD) | set HTTPS_PROXY=dummy.invalid set NO_PROXY=* |
| Windows | PowerShell | $env:HTTPS_PROXY="dummy.invalid" $env:NO_PROXY="*" |
Laat op andere besturingssystemen de HTTPS_PROXY variabele uitgeschakeld als u geen proxy wilt gebruiken.