Freigeben über


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.

Weitere Informationen