Udostępnij za pośrednictwem


Ustawienia konfiguracji narzędzia AzCopy w wersji 10 (Azure Storage)

AzCopy to narzędzie wiersza polecenia, przy użyciu którego można kopiować obiekty blob lub pliki do lub z konta magazynu. Ten artykuł zawiera listę zmiennych środowiskowych, których można użyć do skonfigurowania narzędzia AzCopy w wersji 10.

Uwaga

Jeśli szukasz zawartości ułatwiającej rozpoczęcie pracy z narzędziem AzCopy, zobacz Wprowadzenie do narzędzia AzCopy.

Zmienne środowiskowe narzędzia AzCopy w wersji 10

W poniższej tabeli opisano każdą zmienną środowiskową i podano linki do zawartości, która może pomóc w użyciu zmiennej.

Zmienna środowiskowa opis
AWS_ACCESS_KEY_ID Klucz dostępu usług Amazon Web Services. Udostępnia klucz do autoryzowania za pomocą usług Amazon Web Services.Kopiowanie danych z usługi Amazon S3 do usługi Azure Storage przy użyciu narzędzia AzCopy
AWS_SECRET_ACCESS_KEY Klucz dostępu tajnego usługi Amazon Web Services udostępnia klucz tajny do autoryzacji za pomocą usług Amazon Web Services. Kopiowanie danych z usługi Amazon S3 do usługi Azure Storage przy użyciu narzędzia AzCopy
AZCOPY_ACTIVE_DIRECTORY_ENDPOINT Punkt końcowy firmy Microsoft Entra do użycia. Ta zmienna jest używana tylko do automatycznego logowania. Zamiast tego użyj flagi wiersza polecenia podczas wywoływania polecenia logowania.
AZCOPY_AUTO_LOGIN_TYPE Ustaw tę zmienną na DEVICE, , MSI, SPNAZCLIi PSCRED. Ta zmienna umożliwia autoryzowanie bez użycia azcopy login polecenia . Zobacz Autoryzowanie dostępu do obiektów blob za pomocą narzędzia AzCopy i identyfikatora Entra firmy Microsoft.
AZCOPY_BUFFER_GB Określ maksymalną ilość pamięci systemowej, która ma być używana przez narzędzie AzCopy podczas pobierania i przekazywania plików. Wyrażaj tę wartość w gigabajtach (GB). Zobacz Optymalizowanie użycia pamięci
AZCOPY_CACHE_PROXY_LOOKUP Domyślnie narzędzie AzCopy w systemie Windows buforuje wyszukiwania serwerów proxy na poziomie nazwy hosta (nie biorąc pod uwagę ścieżki adresu URL). Ustaw dowolną inną wartość niż "true", aby wyłączyć pamięć podręczną.
AZCOPY_CONCURRENCY_VALUE Określa liczbę współbieżnych żądań, które mogą wystąpić. Tej zmiennej można użyć do zwiększenia przepływności. Jeśli komputer ma mniej niż 5 procesorów CPU, wartość tej zmiennej jest ustawiona na 32wartość . W przeciwnym razie wartość domyślna jest równa 16-krotności liczby procesorów CPU. Maksymalna wartość domyślna tej zmiennej to 3000, ale można ręcznie ustawić tę wartość wyższą lub niższą. Zobacz Zwiększanie współbieżności
AZCOPY_CONCURRENT_FILES Zastępuje (przybliżoną) liczbę plików, które są w toku w dowolnym momencie, kontrolując liczbę plików, dla których jednocześnie inicjujemy transfery.
AZCOPY_CONCURRENT_SCAN Określa stopień równoległości (maksymalny) używany podczas skanowania. Dotyczy tylko równoległych modułów wyliczających, które obejmują usługi Azure Files/Blobs i lokalne systemy plików.
AZCOPY_CONTENT_TYPE_MAP Zastępuje co najmniej jedno domyślne mapowanie typu MIME zdefiniowane przez system operacyjny. Ustaw tę zmienną na ścieżkę pliku JSON, który definiuje dowolne mapowanie. Oto zawartość przykładowego pliku JSON:

{
  "MIMETypeMapping": {
    ".323": "text/h323",
    ".aaf": "application/octet-stream",
    ".aca": "application/octet-stream",
    ".accdb": "application/msaccess"
     }
}
AZCOPY_DEFAULT_SERVICE_API_VERSION Zastępuje wersję interfejsu API usługi, aby narzędzie AzCopy mogło pomieścić środowiska niestandardowe, takie jak Azure Stack.
AZCOPY_DISABLE_HIERARCHICAL_SCAN Dotyczy tylko wtedy, gdy obiekty blob platformy Azure są źródłem. Skanowanie współbieżne jest szybsze, ale korzysta z interfejsu API listy hierarchicznej, co może spowodować zwiększenie liczby operacji we/wy/koszt. Określ wartość "true", aby poświęcić wydajność, ale zaoszczędzić na kosztach.
AZCOPY_DISABLE_SYSLOG Wyłącza rejestrowanie w dzienniku systemowym lub rejestratorze zdarzeń systemu Windows. Domyślnie narzędzie AzCopy wysyła dzienniki do tych kanałów. Tę zmienną można ustawić na wartość true, jeśli chcesz zmniejszyć szum w dzienniku systemowym lub dzienniku zdarzeń systemu Windows.
AZCOPY_DOWNLOAD_TO_TEMP_PATH Konfiguruje narzędzie AzCopy do pobierania do ścieżki tymczasowej przed rzeczywistym pobraniem. Dozwolone wartości są prawdziwe lub fałszywe
AZCOPY_JOB_PLAN_LOCATION Zastępuje pliki planu zadania (używane do śledzenia postępu i wznawiania), aby uniknąć zapełniania dysku.
AZCOPY_LOG_LOCATION Zastępuje miejsce przechowywania plików dziennika, aby uniknąć zapełniania dysku.
AZCOPY_MSI_CLIENT_ID Identyfikator klienta tożsamości zarządzanej przypisanej przez użytkownika. Użyj polecenia , gdy AZCOPY_AUTO_LOGIN_TYPE jest ustawiona wartość MSI. Zobacz Autoryzowanie bez magazynu wpisów tajnych
AZCOPY_MSI_OBJECT_ID Identyfikator obiektu tożsamości zarządzanej przypisanej przez użytkownika. Użyj polecenia , gdy AZCOPY_AUTO_LOGIN_TYPE jest ustawiona wartość MSI. Zobacz Autoryzowanie bez magazynu wpisów tajnych
AZCOPY_MSI_RESOURCE_STRING Identyfikator zasobu tożsamości zarządzanej przypisanej przez użytkownika. Zobacz Autoryzowanie bez magazynu wpisów tajnych
AZCOPY_PACE_PAGE_BLOBS Czy przepływność stronicowych obiektów blob powinna być automatycznie dopasowywana do limitów usługi? Ustawieniem domyślnym jest true. Ustaw wartość "false", aby wyłączyć
AZCOPY_PARALLEL_STAT_FILES Powoduje, że narzędzie AzCopy wyszukuje właściwości pliku na równoległych "wątkach" podczas skanowania lokalnego systemu plików. Wątki są pobierane z puli zdefiniowanej przez AZCOPY_CONCURRENT_SCAN. Ustawienie wartości true może zwiększyć wydajność skanowania w systemie Linux. Nie jest to wymagane lub zalecane w systemie Windows.
AZCOPY_REQUEST_TRY_TIMEOUT Ustaw liczbę minut, przez które narzędzie AzCopy powinno spróbować przekazać pliki dla każdego żądania przed upływem limitu czasu narzędzia AzCopy.
AZCOPY_SHOW_PERF_STATES W przypadku ustawienia na dowolne dane wyjściowe na ekranie będą zawierać liczby fragmentów według stanu
AZCOPY_SPA_APPLICATION_ID Identyfikator aplikacji rejestracji aplikacji jednostki usługi. Użyj polecenia , gdy AZCOPY_AUTO_LOGIN_TYPE jest ustawiona wartość SPN. Zobacz Autoryzowanie bez magazynu wpisów tajnych
AZCOPY_SPA_CERT_PASSWORD Hasło certyfikatu. Użyj polecenia , gdy AZCOPY_AUTO_LOGIN_TYPE jest ustawiona wartość SPN. Zobacz Autoryzowanie bez magazynu wpisów tajnych
AZCOPY_SPA_CERT_PATH Względna lub w pełni kwalifikowana ścieżka do pliku certyfikatu. Użyj polecenia , gdy AZCOPY_AUTO_LOGIN_TYPE jest ustawiona wartość SPN. Zobacz Autoryzowanie bez magazynu wpisów tajnych
AZCOPY_SPA_CLIENT_SECRET Wpis tajny klienta. Użyj polecenia , gdy AZCOPY_AUTO_LOGIN_TYPE jest ustawiona wartość SPN. Zobacz Autoryzowanie bez magazynu wpisów tajnych
AZCOPY_TENANT_ID Identyfikator dzierżawy firmy Microsoft Entra do użycia na potrzeby logowania interakcyjnego urządzenia OAuth. Ta zmienna jest używana tylko do automatycznego logowania. Zamiast tego użyj flagi wiersza polecenia podczas wywoływania polecenia logowania.
AZCOPY_TUNE_TO_CPU Ustaw wartość false, aby zapobiec używaniu procesora CPU przez narzędzie AzCopy podczas automatycznego dostrajania poziomu współbieżności (na przykład w poleceniu testu porównawczego).
AZCOPY_USER_AGENT_PREFIX Dodaj prefiks do domyślnego agenta użytkownika narzędzia AzCopy, który jest używany do celów telemetrycznych. Spacja jest automatycznie wstawiana.
CPK_ENCRYPTION_KEY Wartość klucza szyfrowania AES-256 zakodowana w formacie Base64. Ta zmienna jest wymagana zarówno dla żądań odczytu, jak i zapisu w przypadku używania kluczy dostarczonych przez klienta do szyfrowania i odszyfrowywania danych w operacjach magazynu obiektów blob. Klucze podane przez klienta można użyć, ustawiając flagę --cpk-by-value=true .
CPK_ENCRYPTION_KEY_SHA256 Algorytm SHA256 zakodowany w formacie Base64 klucza szyfrowania. Ta zmienna jest wymagana zarówno dla żądań odczytu, jak i zapisu w przypadku używania kluczy dostarczonych przez klienta do szyfrowania i odszyfrowywania danych w operacjach magazynu obiektów blob. Klucze podane przez klienta można użyć, ustawiając flagę --cpk-by-value=true .
GOOGLE_APPLICATION_CREDENTIALS Ścieżka bezwzględna do pliku klucza konta usługi Udostępnia klucz autoryzacji w usłudze Google Cloud Storage. Kopiowanie danych z usługi Google Cloud Storage do usługi Azure Storage przy użyciu narzędzia AzCopy (wersja zapoznawcza)
GOOGLE_CLOUD_PROJECT Identyfikator projektu wymagany dla przechodzenia na poziomie usług w usłudze Google Cloud Storage.
HTTPS_PROXY Konfiguruje ustawienia serwera proxy dla narzędzia AzCopy. Ustaw tę zmienną na adres IP serwera proxy i numer portu serwera proxy. Na przykład xx.xxx.xx.xxx:xx. Jeśli uruchomisz narzędzie AzCopy w systemie Windows, narzędzie AzCopy automatycznie wykryje ustawienia serwera proxy, dlatego w systemie Windows nie trzeba używać tego ustawienia. Jeśli zdecydujesz się użyć tego ustawienia w systemie Windows, przesłoni ono automatyczne wykrywanie. Zobacz Konfigurowanie ustawień serwera proxy

Konfigurowanie ustawień serwera proxy

Aby skonfigurować ustawienia serwera proxy dla narzędzia AzCopy, ustaw zmienną HTTPS_PROXY środowiskową. Jeśli uruchomisz narzędzie AzCopy w systemie Windows, narzędzie AzCopy automatycznie wykryje ustawienia serwera proxy, dlatego w systemie Windows nie trzeba używać tego ustawienia. Jeśli zdecydujesz się użyć tego ustawienia w systemie Windows, przesłoni ono automatyczne wykrywanie.

System operacyjny Polecenie
Windows W wierszu polecenia użyj polecenia: set HTTPS_PROXY=<proxy IP>:<proxy port>
W programie PowerShell użyj: $env:HTTPS_PROXY="<proxy IP>:<proxy port>"
Linux export HTTPS_PROXY=<proxy IP>:<proxy port>
macOS export HTTPS_PROXY=<proxy IP>:<proxy port>

obecnie narzędzie AzCopy nie obsługuje serwerów proxy, które wymagają uwierzytelniania przy użyciu protokołu NTLM lub Kerberos.

Pomijanie serwera proxy

Jeśli używasz narzędzia AzCopy w systemie Windows i chcesz poinformować go, aby w ogóle nie używał żadnego serwera proxy (zamiast automatycznego wykrywania ustawień), użyj tych poleceń. Za pomocą tych ustawień narzędzie AzCopy nie wyszuka ani nie spróbuje użyć żadnego serwera proxy.

System operacyjny Środowisko Polecenia
Windows Wiersz polecenia (CMD) set HTTPS_PROXY=dummy.invalid
set NO_PROXY=*
Windows PowerShell $env:HTTPS_PROXY="dummy.invalid"
$env:NO_PROXY="*"

W innych systemach operacyjnych po prostu pozostaw zmienną HTTPS_PROXY niezastawioną, jeśli nie chcesz używać serwera proxy.

Zobacz też