AzCopy v10-Konfigurationseinstellungen (Azure Storage)
AzCopy ist ein Befehlszeilenhilfsprogramm, das Sie verwenden können, um Blobs oder Dateien in oder aus einem Speicherkonto zu kopieren. Dieser Artikel enthält eine Liste der Umgebungsvariablen, die Sie zum Konfigurieren von AzCopy v10 verwenden können.
Hinweis
Inhalte, die Sie beim Einstieg in AzCopy unterstützen, finden Sie unter Erste Schritte mit AzCopy.
AzCopy v10-Umgebungsvariablen
Die folgende Tabelle beschreibt die einzelnen Umgebungsvariablen und enthält Links zu Inhalten, die Sie bei der Verwendung der Variablen unterstützen können.
| Umgebungsvariable | BESCHREIBUNG |
|---|---|
| AWS_ACCESS_KEY_ID | Amazon Web Services-Zugriffsschlüssel. Stellt einen Schlüssel für die Autorisierung bei Amazon Web Services bereit. Kopieren von Daten aus Amazon S3 in Azure Storage mithilfe von AzCopy |
| AWS_SECRET_ACCESS_KEY | Mit dem geheimen Zugriffsschlüssel von Amazon Web Services wird ein geheimer Schlüssel für die Autorisierung bei Amazon Web Services bereitgestellt. Kopieren von Daten aus Amazon S3 in Azure Storage mithilfe von AzCopy |
| AZCOPY_ACTIVE_DIRECTORY_ENDPOINT | Der zu verwendende Microsoft Entra-Endpunkt. Diese Variable dient nur zur automatischen Anmeldung. Verwenden Sie stattdessen das Befehlszeilenflag beim Aufrufen des Anmeldebefehls. |
| AZCOPY_AUTO_LOGIN_TYPE | Legen Sie diese Variable auf DEVICE, MSI, , SPN, AZCLIund PSCRED. Diese Variable bietet die Möglichkeit, die Autorisierung ohne den Befehl azcopy login durchzuführen. Siehe Autorisieren des Zugriffs auf Blobs mit AzCopy und Microsoft Entra ID. |
| AZCOPY_BUFFER_GB | Geben Sie die maximale Kapazität an Systemarbeitsspeicher an, die AzCopy beim Herunterladen und Hochladen von Dateien verwenden soll. Geben Sie diesen Wert in Gigabytes (GB) an. Informationen hierzu finden Sie unter Optimieren der Arbeitsspeicherauslastung. |
| AZCOPY_CACHE_PROXY_LOOKUP | Standardmäßig speichert AzCopy unter Windows Proxyserver-Lookups auf Hostnamensebene zwischen (ohne Berücksichtigung des URL-Pfads). Legen Sie einen anderen Wert als TRUE fest, um den Cache zu deaktivieren. |
| AZCOPY_CONCURRENCY_VALUE | Gibt die zulässige Anzahl gleichzeitiger Anforderungen an. Sie können diese Variable verwenden, um den Durchsatz zu erhöhen. Wenn Ihr Computer über weniger als 5 CPUs verfügt, wird der Wert dieser Variablen auf 32 festgelegt. Andernfalls ist der Standardwert gleich 16, multipliziert mit der Anzahl der CPUs. Der maximale Standardwert dieser Variablen ist 3000, aber Sie können diesen Wert manuell höher oder niedriger festlegen. Weitere Informationen finden Sie unter Erhöhen der Parallelität. |
| AZCOPY_CONCURRENT_FILES | Überschreibt die (ungefähre) Anzahl gleichzeitig verarbeiteter Dateien, indem gesteuert wird, für wie viele Dateien gleichzeitig Übertragungen initiiert werden. |
| AZCOPY_CONCURRENT_SCAN | Steuert den (maximalen) Parallelitätsgrad, der während der Überprüfung verwendet wird. Betrifft nur parallelisierte Enumeratoren, zu denen Azure Files/Blobs und lokale Dateisysteme gehören. |
| AZCOPY_CONTENT_TYPE_MAP | Hiermit wird mindestens eine von Ihrem Betriebssystem definierte Standardzuordnung des MIME-Typs überschrieben. Legen Sie diese Variable auf den Pfad einer JSON-Datei fest, die eine beliebige Zuordnung definiert. Hier sehen Sie den Inhalt einer JSON-Beispieldatei: { "MIMETypeMapping": { ".323": "text/h323", ".aaf": "application/octet-stream", ".aca": "application/octet-stream", ".accdb": "application/msaccess" } } |
| AZCOPY_DEFAULT_SERVICE_API_VERSION | Überschreibt die Dienst-API-Version, sodass AzCopy benutzerdefinierte Umgebungen wie Azure Stack umfassen kann. |
| AZCOPY_DISABLE_HIERARCHICAL_SCAN | Gilt nur, wenn Azure-Blobs als Quelle verwendet werden. Die gleichzeitige Überprüfung ist schneller, verwendet jedoch die API für hierarchische Auflistungen. Dies kann zur Erhöhung der E/A/Kosten führen. Geben Sie TRUE an, um zugunsten von Kosteneinsparungen eine geringere Leistung in Kauf zu nehmen. |
| AZCOPY_DISABLE_SYSLOG | Deaktiviert die Protokollierung in Syslog oder den Windows Event Logger. Standardmäßig sendet AzCopy-Protokolle an diese Kanäle. Sie können diese Variable auf „true“ festlegen, wenn Sie das Rauschen in Syslog oder im Windows-Ereignisprotokoll reduzieren möchten. |
| AZCOPY_DOWNLOAD_TO_TEMP_PATH | Konfiguriert AzCopy, um Dateien vor dem eigentlichen Download in einen temporären Pfad herunterzuladen. Zulässige Werte sind „true“ oder „false“. |
| AZCOPY_JOB_PLAN_LOCATION | Überschreibt den Speicherort für Auftragsplandateien (für die Fortschrittsnachverfolgung und Fortsetzung), um das Auffüllen eines Datenträgers zu vermeiden. |
| AZCOPY_LOG_LOCATION | Überschreibt den Speicherort für Protokolldateien, um das Auffüllen eines Datenträgers zu vermeiden. |
| AZCOPY_MSI_CLIENT_ID | Die Client-ID einer benutzerseitig zugewiesenen verwalteten Identität. Verwenden Sie sie, wenn AZCOPY_AUTO_LOGIN_TYPE auf MSI festgelegt ist. Informationen hierzu finden Sie unter Autorisieren ohne Geheimnisspeicher. |
| AZCOPY_MSI_OBJECT_ID | Die Objekt-ID der benutzerseitig zugewiesenen verwalteten Identität. Verwenden Sie sie, wenn AZCOPY_AUTO_LOGIN_TYPE auf MSI festgelegt ist. Informationen hierzu finden Sie unter Autorisieren ohne Geheimnisspeicher. |
| AZCOPY_MSI_RESOURCE_STRING | Die Ressourcen-ID der benutzerseitig zugewiesenen verwalteten Identität. Informationen hierzu finden Sie unter Autorisieren ohne Geheimnisspeicher. |
| AZCOPY_PACE_PAGE_BLOBS | Gibt an, ob der Durchsatz für Seitenblobs automatisch entsprechend den Dienstgrenzwerten angepasst werden soll. Der Standardwert ist "True". Legen Sie diese Einstellung auf FALSE fest, um sie zu deaktivieren. |
| AZCOPY_PARALLEL_STAT_FILES | Veranlasst AzCopy zur Suche nach Dateieigenschaften für parallele „Threads“ bei der Überprüfung des lokalen Dateisystems. Die Threads werden aus dem durch AZCOPY_CONCURRENT_SCAN definierten Pool abgerufen. Durch Festlegen dieser Einstellung auf TRUE kann die Überprüfungsleistung unter Linux verbessert werden. Unter Windows nicht erforderlich und nicht empfohlen. |
| AZCOPY_REQUEST_TRY_TIMEOUT | Legen Sie die Anzahl der Minuten fest, die AzCopy versuchen soll, Dateien für jede Anforderung hochzuladen, bevor ein Timeout für AzCopy auftritt. |
| AZCOPY_SHOW_PERF_STATES | Wenn diese Einstellung auf einen beliebigen Wert festgelegt wird, enthält die Ausgabe auf dem Bildschirm die Anzahl von Blöcken nach Status. |
| AZCOPY_SPA_APPLICATION_ID | Die Anwendungs-ID der App-Registrierung Ihres Dienstprinzipals. Verwenden Sie sie, wenn AZCOPY_AUTO_LOGIN_TYPE auf SPN festgelegt ist. Informationen hierzu finden Sie unter Autorisieren ohne Geheimnisspeicher. |
| AZCOPY_SPA_CERT_PASSWORD | Das Kennwort eines Zertifikats. Verwenden Sie sie, wenn AZCOPY_AUTO_LOGIN_TYPE auf SPN festgelegt ist. Informationen hierzu finden Sie unter Autorisieren ohne Geheimnisspeicher. |
| AZCOPY_SPA_CERT_PATH | Der relative oder vollqualifizierte Pfad zu einer Zertifikatdatei. Verwenden Sie sie, wenn AZCOPY_AUTO_LOGIN_TYPE auf SPN festgelegt ist. Informationen hierzu finden Sie unter Autorisieren ohne Geheimnisspeicher. |
| AZCOPY_SPA_CLIENT_SECRET | Der geheime Schlüssel des Clients. Verwenden Sie sie, wenn AZCOPY_AUTO_LOGIN_TYPE auf SPN festgelegt ist. Informationen hierzu finden Sie unter Autorisieren ohne Geheimnisspeicher. |
| AZCOPY_TENANT_ID | Die Microsoft Entra-Mandanten-ID, die für die interaktive OAuth-Geräteanmeldung verwendet werden soll. Diese Variable dient nur zur automatischen Anmeldung. Verwenden Sie stattdessen das Befehlszeilenflag beim Aufrufen des Anmeldebefehls. |
| AZCOPY_TUNE_TO_CPU | Durch Festlegen auf FALSE wird verhindert, dass AzCopy die CPU-Auslastung beim automatischen Optimieren der Parallelitätsstufe berücksichtigt (z. B. im Benchmarkbefehl). |
| AZCOPY_USER_AGENT_PREFIX | Fügen Sie dem standardmäßigen AzCopy-Benutzer-Agent für Telemetriezwecke ein Präfix hinzu. Ein Leerzeichen wird automatisch eingefügt. |
| CPK_ENCRYPTION_KEY | Ein Base64-codierter AES-256-Verschlüsselungsschlüsselwert. Diese Variable ist für Lese- und Schreibanforderungen erforderlich, wenn kundenseitig bereitgestellte Schlüssel zum Verschlüsseln und Entschlüsseln von Daten in Blob Storage-Vorgängen verwendet werden. Sie können kundenseitig bereitgestellte Schlüssel verwenden, indem Sie das --cpk-by-value=true-Flag festlegen. |
| CPK_ENCRYPTION_KEY_SHA256 | Der Base64-codierte SHA256 des Verschlüsselungsschlüssels. Diese Variable ist für Lese- und Schreibanforderungen erforderlich, wenn kundenseitig bereitgestellte Schlüssel zum Verschlüsseln und Entschlüsseln von Daten in Blob Storage-Vorgängen verwendet werden. Sie können kundenseitig bereitgestellte Schlüssel verwenden, indem Sie das --cpk-by-value=true-Flag festlegen. |
| GOOGLE_APPLICATION_CREDENTIALS | Der absolute Pfad zur Dienstkontoschlüssel-Datei. Stellt einen Schlüssel für die Autorisierung bei Google Cloud Storage bereit. Kopieren von Daten aus Google Cloud Storage in Azure Storage mithilfe von AzCopy (Vorschau) |
| GOOGLE_CLOUD_PROJECT | Projekt-ID, die für Traversierungen auf Dienstebene in Google-Cloudspeicher erforderlich ist. |
| HTTPS_PROXY | Konfiguriert Proxyeinstellungen für AzCopy. Legen Sie diese Variable auf die Proxy-IP-Adresse und die Proxyportnummer fest. Beispiel: xx.xxx.xx.xxx:xx. Unter Windows ist diese Einstellung nicht erforderlich, da AzCopy Proxyeinstellungen automatisch erkennt. Falls Sie diese Einstellung unter Windows verwenden, wird dadurch die automatische Erkennung außer Kraft gesetzt. Informationen hierzu finden Sie unter Konfigurieren von Proxyeinstellungen. |
Konfigurieren von Proxyeinstellungen
Um die Proxyeinstellungen für AzCopy zu konfigurieren, legen Sie die Umgebungsvariable HTTPS_PROXY fest. Unter Windows ist diese Einstellung nicht erforderlich, da AzCopy Proxyeinstellungen automatisch erkennt. Falls Sie diese Einstellung unter Windows verwenden, wird dadurch die automatische Erkennung außer Kraft gesetzt.
| Betriebssystem | Get-Help |
|---|---|
| Windows | Verwenden Sie in einer Eingabeaufforderung: set HTTPS_PROXY=<proxy IP>:<proxy port>Verwenden Sie 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> |
AzCopy unterstützt zurzeit keine Proxys, für die eine Authentifizierung mit NTLM oder Kerberos erforderlich ist.
Umgehen eines Proxys
Wenn AzCopy unter Windows ausgeführt wird und Sie angeben möchten, dass gar kein Proxy verwendet werden soll (anstatt die Einstellungen automatisch zu erkennen), verwenden Sie diese Befehle. Mit diesen Einstellungen sucht AzCopy keinen Proxy und versucht auch nicht, einen zu verwenden.
| Betriebssystem | Environment | Befehle |
|---|---|---|
| Windows | Befehlszeile (CMD) | set HTTPS_PROXY=dummy.invalid set NO_PROXY=* |
| Windows | PowerShell | $env:HTTPS_PROXY="dummy.invalid" $env:NO_PROXY="*" |
Bei anderen Betriebssystemen belassen Sie die HTTPS_PROXY-Variable einfach nicht festgelegt, wenn Sie keinen Proxy verwenden möchten.