Freigeben über

az storage file copy

Note

Diese Befehlsgruppe verfügt über Befehle, die sowohl in Azure CLI als auch in mindestens einer Erweiterung definiert sind. Installieren Sie jede Erweiterung, um von ihren erweiterten Funktionen zu profitieren. Erfahren Sie mehr über Erweiterungen.

Verwalten von Dateikopievorgängen.

Befehle

Name Beschreibung Typ Status
az storage file copy cancel

Abbrechen eines laufenden Kopiervorgangs.

 Core GA
az storage file copy cancel (storage-preview Erweiterung)

Abbrechen eines laufenden Kopiervorgangs.

 Extension GA
az storage file copy start

Kopieren Sie eine Datei asynchron.

 Core GA
az storage file copy start (storage-preview Erweiterung)

Kopieren Sie eine Datei asynchron.

 Extension GA
az storage file copy start-batch

Kopieren Sie mehrere Dateien oder Blobs in eine Dateifreigabe.

 Core GA
az storage file copy start-batch (storage-preview Erweiterung)

Kopieren Sie mehrere Dateien oder Blobs in eine Dateifreigabe.

 Extension GA

az storage file copy cancel

Bearbeiten

Abbrechen eines laufenden Kopiervorgangs.

Dadurch wird eine Zieldatei mit null Länge und vollständigen Metadaten beibehalten. Dadurch wird ein Fehler ausgelöst, wenn der Kopiervorgang bereits beendet wurde.

az storage file copy cancel --copy-id
                            --destination-path
                            --destination-share
                            [--account-key]
                            [--account-name]
                            [--auth-mode {key, login}]
                            [--backup-intent --enable-file-backup-request-intent]
                            [--connection-string]
                            [--disallow-trailing-dot {false, true}]
                            [--file-endpoint]
                            [--sas-token]
                            [--timeout]

Erforderliche Parameter

--copy-id

Der kopiervorgang, der abgebrochen werden soll. Dies kann entweder eine ID oder eine Instanz von FileProperties sein.

--destination-path -p

Der Pfad zur Datei innerhalb der Dateifreigabe.

--destination-share -s

Name der Zielfreigabe. Die Freigabe muss vorhanden sein.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--account-key

Speicherkontoschlüssel. Muss zusammen mit dem Namen oder dem Dienstendpunkt des Speicherkontos verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

Eigenschaft Wert
Parametergruppe: Storage Account Arguments
--account-name

Speicherkontoname. Verwandte Umgebungsvariable: AZURE_STORAGE_ACCOUNT. Muss in Verbindung mit einem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Wenn keines vorhanden ist, versucht der Befehl, den Speicherkontoschlüssel mithilfe des authentifizierten Azure-Kontos abzufragen. Wenn eine große Anzahl von Speicherbefehlen ausgeführt wird, kann das API-Kontingent erreicht werden.

Eigenschaft Wert
Parametergruppe: Storage Account Arguments
--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der Modus "Anmeldung" verwendet Ihre Anmeldeinformationen direkt für die Authentifizierung. Der Legacy-Modus "Schlüssel" versucht, einen Kontoschlüssel anzufordern, wenn keine Authentifizierungsparameter für das Konto vorhanden sind. Umgebungsvariable: AZURE_STORAGE_AUTH_MODE.

Eigenschaft Wert
Zulässige Werte: key, login
--backup-intent --enable-file-backup-request-intent

Erforderlicher Parameter für die Verwendung mit der OAuth-Authentifizierung (Azure AD) für Dateien. Dadurch werden alle Berechtigungsprüfungen auf Datei-/Verzeichnisebene umgangen und der Zugriff basierend auf den zulässigen Datenaktionen zugelassen, auch wenn ACLs für diese Dateien/Verzeichnisse vorhanden sind.

Eigenschaft Wert
Standardwert: False
--connection-string

Verbindungszeichenfolge für Speicherkonto. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

Eigenschaft Wert
Parametergruppe: Storage Account Arguments
--disallow-trailing-dot

Wenn true, wird der nachfolgende Punkt vom Ziel-URI gekürzt. Standardwert ist "False".

Eigenschaft Wert
Standardwert: False
Zulässige Werte: false, true
--file-endpoint

Speicherdatendienstendpunkt. Muss in Verbindung mit einem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Sie finden jeden primären Dienstendpunkt mit az storage account show. Umgebungsvariable: AZURE_STORAGE_SERVICE_ENDPOINT.

Eigenschaft Wert
Parametergruppe: Storage Account Arguments
--sas-token

Eine freigegebene Zugriffssignatur (SAS). Muss zusammen mit dem Namen oder dem Dienstendpunkt des Speicherkontos verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

Eigenschaft Wert
Parametergruppe: Storage Account Arguments
--timeout

Anforderungstimeout in Sekunden. Gilt für jeden Aufruf des Diensts.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az storage file copy cancel (storage-preview Erweiterung)

Abbrechen eines laufenden Kopiervorgangs.

Dadurch wird eine Zieldatei mit null Länge und vollständigen Metadaten beibehalten. Dadurch wird ein Fehler ausgelöst, wenn der Kopiervorgang bereits beendet wurde.

az storage file copy cancel --copy-id
                            --destination-path
                            --destination-share
                            [--account-key]
                            [--account-name]
                            [--auth-mode {key, login}]
                            [--backup-intent --enable-file-backup-request-intent]
                            [--connection-string]
                            [--disallow-trailing-dot {false, true}]
                            [--sas-token]
                            [--timeout]

Erforderliche Parameter

--copy-id

Der kopiervorgang, der abgebrochen werden soll. Dies kann entweder eine ID oder eine Instanz von FileProperties sein.

--destination-path -p

Der Pfad zur Datei innerhalb der Dateifreigabe.

--destination-share -s

Name der Zielfreigabe. Die Freigabe muss vorhanden sein.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--account-key

Speicherkontoschlüssel. Muss zusammen mit dem Namen des Speicherkontos verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

Eigenschaft Wert
Parametergruppe: Storage Account Arguments
--account-name

Speicherkontoname. Verwandte Umgebungsvariable: AZURE_STORAGE_ACCOUNT. Muss in Verbindung mit einem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Wenn keines vorhanden ist, versucht der Befehl, den Speicherkontoschlüssel mithilfe des authentifizierten Azure-Kontos abzufragen. Wenn eine große Anzahl von Speicherbefehlen ausgeführt wird, kann das API-Kontingent erreicht werden.

Eigenschaft Wert
Parametergruppe: Storage Account Arguments
--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der Modus "Anmeldung" verwendet Ihre Anmeldeinformationen direkt für die Authentifizierung. Der Legacy-Modus "Schlüssel" versucht, einen Kontoschlüssel anzufordern, wenn keine Authentifizierungsparameter für das Konto vorhanden sind. Umgebungsvariable: AZURE_STORAGE_AUTH_MODE.

Eigenschaft Wert
Zulässige Werte: key, login
--backup-intent --enable-file-backup-request-intent

Erforderlicher Parameter für die Verwendung mit der OAuth-Authentifizierung (Azure AD) für Dateien. Dadurch werden alle Berechtigungsprüfungen auf Datei-/Verzeichnisebene umgangen und der Zugriff basierend auf den zulässigen Datenaktionen zugelassen, auch wenn ACLs für diese Dateien/Verzeichnisse vorhanden sind.

Eigenschaft Wert
Standardwert: False
--connection-string

Verbindungszeichenfolge für Speicherkonto. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

Eigenschaft Wert
Parametergruppe: Storage Account Arguments
--disallow-trailing-dot

Wenn true, wird der nachfolgende Punkt vom Ziel-URI gekürzt. Standardwert ist "False".

Eigenschaft Wert
Standardwert: False
Zulässige Werte: false, true
--sas-token

Eine freigegebene Zugriffssignatur (SAS). Muss zusammen mit dem Namen des Speicherkontos verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

Eigenschaft Wert
Parametergruppe: Storage Account Arguments
--timeout

Anforderungstimeout in Sekunden. Gilt für jeden Aufruf des Diensts.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az storage file copy start

Bearbeiten

Kopieren Sie eine Datei asynchron.

az storage file copy start --destination-path
                           --destination-share
                           [--account-key]
                           [--account-name]
                           [--auth-mode {key, login}]
                           [--backup-intent --enable-file-backup-request-intent]
                           [--connection-string]
                           [--disallow-source-trailing-dot --disallow-src-trailing {false, true}]
                           [--disallow-trailing-dot {false, true}]
                           [--file-endpoint]
                           [--file-mode]
                           [--file-mode-copy-mode {override, source}]
                           [--file-snapshot]
                           [--group]
                           [--metadata]
                           [--owner]
                           [--owner-copy-mode {override, source}]
                           [--sas-token]
                           [--source-account-key]
                           [--source-account-name]
                           [--source-blob]
                           [--source-container]
                           [--source-path]
                           [--source-sas]
                           [--source-share]
                           [--source-snapshot]
                           [--source-uri]
                           [--timeout]

Beispiele

Kopieren Sie eine Datei asynchron.

az storage file copy start --source-account-name srcaccount --source-account-key 00000000 --source-path <srcpath-to-file> --source-share srcshare --destination-path <destpath-to-file> --destination-share destshare --account-name destaccount --account-key 00000000

Kopieren Sie eine Datei asynchron vom Quell-URI in das Zielspeicherkonto mit sas-Token.

az storage file copy start --source-uri "https://srcaccount.file.core.windows.net/myshare/mydir/myfile?<sastoken>" --destination-path <destpath-to-file> --destination-share destshare --account-name destaccount --sas-token <destination-sas>

Kopieren Sie eine Datei asynchron von der Dateimomentaufnahme in das Zielspeicherkonto mit sas-Token.

az storage file copy start --source-account-name srcaccount --source-account-key 00000000 --source-path <srcpath-to-file> --source-share srcshare --file-snapshot "2020-03-02T13:51:54.0000000Z" --destination-path <destpath-to-file> --destination-share destshare --account-name destaccount --sas-token <destination-sas>

Kopieren Sie eine Datei mit dem Quelldateimodus, der Gruppe, dem Besitzer.

az storage file copy start --source-account-name srcaccount --source-path srcpath --source-share srcshare --destination-path dstpath --destination-share dstshare --owner-copy-mode Source --file-mode-copy-mode Source

Kopieren Sie eine Datei mit dem überschriebenen Dateimodus, der Gruppe, dem Besitzer.

az storage file copy start --source-account-name srcaccount --source-path srcpath --source-share srcshare --destination-path dstpath --destination-share dstshare --owner-copy-mode Override --file-mode-copy-mode Override --file-mode rw-rw-rw- --owner 4 --group 5

Erforderliche Parameter

--destination-path -p

Der Pfad zur Datei innerhalb der Dateifreigabe.

--destination-share -s

Name der Zielfreigabe. Die Freigabe muss vorhanden sein.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--account-key

Speicherkontoschlüssel. Muss zusammen mit dem Namen oder dem Dienstendpunkt des Speicherkontos verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

Eigenschaft Wert
Parametergruppe: Storage Account Arguments
--account-name

Speicherkontoname. Verwandte Umgebungsvariable: AZURE_STORAGE_ACCOUNT. Muss in Verbindung mit einem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Wenn keines vorhanden ist, versucht der Befehl, den Speicherkontoschlüssel mithilfe des authentifizierten Azure-Kontos abzufragen. Wenn eine große Anzahl von Speicherbefehlen ausgeführt wird, kann das API-Kontingent erreicht werden.

Eigenschaft Wert
Parametergruppe: Storage Account Arguments
--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der Modus "Anmeldung" verwendet Ihre Anmeldeinformationen direkt für die Authentifizierung. Der Legacy-Modus "Schlüssel" versucht, einen Kontoschlüssel anzufordern, wenn keine Authentifizierungsparameter für das Konto vorhanden sind. Umgebungsvariable: AZURE_STORAGE_AUTH_MODE.

Eigenschaft Wert
Zulässige Werte: key, login
--backup-intent --enable-file-backup-request-intent

Erforderlicher Parameter für die Verwendung mit der OAuth-Authentifizierung (Azure AD) für Dateien. Dadurch werden alle Berechtigungsprüfungen auf Datei-/Verzeichnisebene umgangen und der Zugriff basierend auf den zulässigen Datenaktionen zugelassen, auch wenn ACLs für diese Dateien/Verzeichnisse vorhanden sind.

Eigenschaft Wert
Standardwert: False
--connection-string

Verbindungszeichenfolge für Speicherkonto. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

Eigenschaft Wert
Parametergruppe: Storage Account Arguments
--disallow-source-trailing-dot --disallow-src-trailing

Wenn true, wird der nachfolgende Punkt aus dem Quell-URI gekürzt. Standardwert ist "False".

Eigenschaft Wert
Standardwert: False
Zulässige Werte: false, true
--disallow-trailing-dot

Wenn true, wird der nachfolgende Punkt vom Ziel-URI gekürzt. Standardwert ist "False".

Eigenschaft Wert
Standardwert: False
Zulässige Werte: false, true
--file-endpoint

Speicherdatendienstendpunkt. Muss in Verbindung mit einem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Sie finden jeden primären Dienstendpunkt mit az storage account show. Umgebungsvariable: AZURE_STORAGE_SERVICE_ENDPOINT.

Eigenschaft Wert
Parametergruppe: Storage Account Arguments
--file-mode

Die Modusberechtigungen, die für die Datei festgelegt werden sollen. Gilt nur für NFS-Dateien. Arbeiten Sie nur mit Parametern --file-mode-copy-mode Overridezusammen. Symbolisch (rwxrw-rw-) wird unterstützt. Das klebige Bit wird ebenfalls unterstützt und wird entweder durch den Buchstaben t oder T am endgültigen Zeichenplatz dargestellt, je nachdem, ob das Ausführungsbit für die andere Kategorie festgelegt oder nicht festgelegt ist, das Fehlen von "t" oder "T" nicht festgelegt ist."

--file-mode-copy-mode

Gilt nur für NFS-Dateien. Gilt nur, wenn die Kopierquelle eine Datei ist. Bestimmt das Kopierverhalten der Modusbits der Zieldatei. Wenn sie nicht ausgefüllt ist, weist die Zieldatei den Standarddateimodus auf.

Eigenschaft Wert
Zulässige Werte: override, source
--file-snapshot

Die Dateimomentaufnahme für das Quellspeicherkonto.

Eigenschaft Wert
Parametergruppe: Copy Source Arguments
--group

Gilt nur für NFS-Dateien. Arbeiten Sie nur mit Parametern --owner-copy-mode Overridezusammen. Der Besitzergruppenbezeichner (GID), der für das Verzeichnis festgelegt werden soll. Der Standardwert ist 0 (Stammgruppe).

--metadata

Metadaten in durch Leerzeichen getrennten Schlüssel-Wert-Paaren. Dadurch werden alle vorhandenen Metadaten überschrieben.

--owner

Gilt nur für NFS-Dateien. Arbeiten Sie nur mit Parametern --owner-copy-mode Overridezusammen. Der Benutzerbezeichner (UID) des Besitzers, der für das Verzeichnis festgelegt werden soll. Der Standardwert ist 0 (Stamm).

--owner-copy-mode

Gilt nur für NFS-Dateien. Gilt nur, wenn die Kopierquelle eine Datei ist. Bestimmt das Kopierverhalten des Besitzers und der Gruppe der Zieldatei. Wenn sie nicht ausgefüllt ist, weist die Zieldatei den Standardbesitzer und die Standardgruppe auf.

Eigenschaft Wert
Zulässige Werte: override, source
--sas-token

Eine freigegebene Zugriffssignatur (SAS). Muss zusammen mit dem Namen oder dem Dienstendpunkt des Speicherkontos verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

Eigenschaft Wert
Parametergruppe: Storage Account Arguments
--source-account-key

Der Speicherkontoschlüssel des Quell-BLOB.

Eigenschaft Wert
Parametergruppe: Copy Source Arguments
--source-account-name

Der Name des Speicherkontos des Quell-BLOB.

Eigenschaft Wert
Parametergruppe: Copy Source Arguments
--source-blob

Der Blobname für das Quellspeicherkonto.

Eigenschaft Wert
Parametergruppe: Copy Source Arguments
--source-container

Der Containername für das Quellspeicherkonto.

Eigenschaft Wert
Parametergruppe: Copy Source Arguments
--source-path

Der Dateipfad für das Quellspeicherkonto.

Eigenschaft Wert
Parametergruppe: Copy Source Arguments
--source-sas

Die Signatur für den freigegebenen Zugriff für das Quellspeicherkonto.

Eigenschaft Wert
Parametergruppe: Copy Source Arguments
--source-share

Der Freigabename für das Quellspeicherkonto.

Eigenschaft Wert
Parametergruppe: Copy Source Arguments
--source-snapshot

Die BLOB-Momentaufnahme für das Quellspeicherkonto.

Eigenschaft Wert
Parametergruppe: Copy Source Arguments
--source-uri -u

Eine URL von bis zu 2 KB Länge, die eine Azure-Datei oder ein Blob angibt. Der Wert sollte URL-codiert sein, wie er in einem Anforderungs-URI angezeigt wird. Wenn sich die Quelle in einem anderen Konto befindet, muss die Quelle entweder öffentlich sein oder über eine freigegebene Zugriffssignatur authentifiziert werden. Wenn die Quelle öffentlich ist, ist keine Authentifizierung erforderlich. Beispiele: https://myaccount.file.core.windows.net/myshare/mydir/myfilehttps://otheraccount.file.core.windows.net/myshare/mydir/myfile?sastoken.

Eigenschaft Wert
Parametergruppe: Copy Source Arguments
--timeout

Anforderungstimeout in Sekunden. Gilt für jeden Aufruf des Diensts.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az storage file copy start (storage-preview Erweiterung)

Kopieren Sie eine Datei asynchron.

az storage file copy start --destination-path
                           --destination-share
                           [--account-key]
                           [--account-name]
                           [--auth-mode {key, login}]
                           [--backup-intent --enable-file-backup-request-intent]
                           [--connection-string]
                           [--disallow-source-trailing-dot --disallow-src-trailing {false, true}]
                           [--disallow-trailing-dot {false, true}]
                           [--file-snapshot]
                           [--metadata]
                           [--sas-token]
                           [--source-account-key]
                           [--source-account-name]
                           [--source-blob]
                           [--source-container]
                           [--source-path]
                           [--source-sas]
                           [--source-share]
                           [--source-snapshot]
                           [--source-uri]
                           [--timeout]

Beispiele

Kopieren Sie eine Datei asynchron.

az storage file copy start --source-account-name srcaccount --source-account-key 00000000 --source-path <srcpath-to-file> --source-share srcshare --destination-path <destpath-to-file> --destination-share destshare --account-name destaccount --account-key 00000000

Kopieren Sie eine Datei asynchron vom Quell-URI in das Zielspeicherkonto mit sas-Token.

az storage file copy start --source-uri "https://srcaccount.file.core.windows.net/myshare/mydir/myfile?<sastoken>" --destination-path <destpath-to-file> --destination-share destshare --account-name destaccount --sas-token <destination-sas>

Kopieren Sie eine Datei asynchron von der Dateimomentaufnahme in das Zielspeicherkonto mit sas-Token.

az storage file copy start --source-account-name srcaccount --source-account-key 00000000 --source-path <srcpath-to-file> --source-share srcshare --file-snapshot "2020-03-02T13:51:54.0000000Z" --destination-path <destpath-to-file> --destination-share destshare --account-name destaccount --sas-token <destination-sas>

Erforderliche Parameter

--destination-path -p

Der Pfad zur Datei innerhalb der Dateifreigabe.

--destination-share -s

Name der Zielfreigabe. Die Freigabe muss vorhanden sein.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--account-key

Speicherkontoschlüssel. Muss zusammen mit dem Namen des Speicherkontos verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

Eigenschaft Wert
Parametergruppe: Storage Account Arguments
--account-name

Speicherkontoname. Verwandte Umgebungsvariable: AZURE_STORAGE_ACCOUNT. Muss in Verbindung mit einem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Wenn keines vorhanden ist, versucht der Befehl, den Speicherkontoschlüssel mithilfe des authentifizierten Azure-Kontos abzufragen. Wenn eine große Anzahl von Speicherbefehlen ausgeführt wird, kann das API-Kontingent erreicht werden.

Eigenschaft Wert
Parametergruppe: Storage Account Arguments
--auth-mode

Der Modus, in dem der Befehl ausgeführt werden soll. Der Modus "Anmeldung" verwendet Ihre Anmeldeinformationen direkt für die Authentifizierung. Der Legacy-Modus "Schlüssel" versucht, einen Kontoschlüssel anzufordern, wenn keine Authentifizierungsparameter für das Konto vorhanden sind. Umgebungsvariable: AZURE_STORAGE_AUTH_MODE.

Eigenschaft Wert
Zulässige Werte: key, login
--backup-intent --enable-file-backup-request-intent

Erforderlicher Parameter für die Verwendung mit der OAuth-Authentifizierung (Azure AD) für Dateien. Dadurch werden alle Berechtigungsprüfungen auf Datei-/Verzeichnisebene umgangen und der Zugriff basierend auf den zulässigen Datenaktionen zugelassen, auch wenn ACLs für diese Dateien/Verzeichnisse vorhanden sind.

Eigenschaft Wert
Standardwert: False
--connection-string

Verbindungszeichenfolge für Speicherkonto. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

Eigenschaft Wert
Parametergruppe: Storage Account Arguments
--disallow-source-trailing-dot --disallow-src-trailing

Wenn true, wird der nachfolgende Punkt aus dem Quell-URI gekürzt. Standardwert ist "False".

Eigenschaft Wert
Standardwert: False
Zulässige Werte: false, true
--disallow-trailing-dot

Wenn true, wird der nachfolgende Punkt vom Ziel-URI gekürzt. Standardwert ist "False".

Eigenschaft Wert
Standardwert: False
Zulässige Werte: false, true
--file-snapshot

Die Dateimomentaufnahme für das Quellspeicherkonto.

Eigenschaft Wert
Parametergruppe: Copy Source Arguments
--metadata

Metadaten in durch Leerzeichen getrennten Schlüssel-Wert-Paaren. Dadurch werden alle vorhandenen Metadaten überschrieben.

--sas-token

Eine freigegebene Zugriffssignatur (SAS). Muss zusammen mit dem Namen des Speicherkontos verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

Eigenschaft Wert
Parametergruppe: Storage Account Arguments
--source-account-key

Der Speicherkontoschlüssel des Quell-BLOB.

Eigenschaft Wert
Parametergruppe: Copy Source Arguments
--source-account-name

Der Name des Speicherkontos des Quell-BLOB.

Eigenschaft Wert
Parametergruppe: Copy Source Arguments
--source-blob

Der Blobname für das Quellspeicherkonto.

Eigenschaft Wert
Parametergruppe: Copy Source Arguments
--source-container

Der Containername für das Quellspeicherkonto.

Eigenschaft Wert
Parametergruppe: Copy Source Arguments
--source-path

Der Dateipfad für das Quellspeicherkonto.

Eigenschaft Wert
Parametergruppe: Copy Source Arguments
--source-sas

Die Signatur für den freigegebenen Zugriff für das Quellspeicherkonto.

Eigenschaft Wert
Parametergruppe: Copy Source Arguments
--source-share

Der Freigabename für das Quellspeicherkonto.

Eigenschaft Wert
Parametergruppe: Copy Source Arguments
--source-snapshot

Die BLOB-Momentaufnahme für das Quellspeicherkonto.

Eigenschaft Wert
Parametergruppe: Copy Source Arguments
--source-uri -u

Eine URL von bis zu 2 KB Länge, die eine Azure-Datei oder ein Blob angibt. Der Wert sollte URL-codiert sein, wie er in einem Anforderungs-URI angezeigt wird. Wenn sich die Quelle in einem anderen Konto befindet, muss die Quelle entweder öffentlich sein oder über eine freigegebene Zugriffssignatur authentifiziert werden. Wenn die Quelle öffentlich ist, ist keine Authentifizierung erforderlich. Beispiele: https://myaccount.file.core.windows.net/myshare/mydir/myfilehttps://otheraccount.file.core.windows.net/myshare/mydir/myfile?sastoken.

Eigenschaft Wert
Parametergruppe: Copy Source Arguments
--timeout

Anforderungstimeout in Sekunden. Gilt für jeden Aufruf des Diensts.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az storage file copy start-batch

Bearbeiten

Kopieren Sie mehrere Dateien oder Blobs in eine Dateifreigabe.

az storage file copy start-batch [--account-key]
                                 [--account-name]
                                 [--connection-string]
                                 [--destination-path]
                                 [--destination-share]
                                 [--disallow-source-trailing-dot --disallow-src-trailing {false, true}]
                                 [--disallow-trailing-dot {false, true}]
                                 [--dryrun]
                                 [--file-endpoint]
                                 [--metadata]
                                 [--pattern]
                                 [--sas-token]
                                 [--source-account-key]
                                 [--source-account-name]
                                 [--source-container]
                                 [--source-sas]
                                 [--source-share]
                                 [--source-uri]
                                 [--timeout]

Beispiele

Kopieren Sie alle Dateien in einer Dateifreigabe in ein anderes Speicherkonto.

az storage file copy start-batch --source-account-name srcaccount --source-account-key 00000000 --source-share srcshare --destination-path <destpath-to-directory> --destination-share destshare --account-name destaccount --account-key 00000000

Kopieren Sie alle Dateien in einer Dateifreigabe in ein anderes Speicherkonto. mit sas-Token.

az storage file copy start-batch --source-uri "https://srcaccount.file.core.windows.net/myshare?<sastoken>" --destination-path <destpath-to-directory> --destination-share destshare --account-name destaccount --sas-token <destination-sas>

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--account-key

Speicherkontoschlüssel. Muss zusammen mit dem Namen oder dem Dienstendpunkt des Speicherkontos verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

Eigenschaft Wert
Parametergruppe: Storage Account Arguments
--account-name

Speicherkontoname. Verwandte Umgebungsvariable: AZURE_STORAGE_ACCOUNT. Muss in Verbindung mit einem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Wenn keines vorhanden ist, versucht der Befehl, den Speicherkontoschlüssel mithilfe des authentifizierten Azure-Kontos abzufragen. Wenn eine große Anzahl von Speicherbefehlen ausgeführt wird, kann das API-Kontingent erreicht werden.

Eigenschaft Wert
Parametergruppe: Storage Account Arguments
--connection-string

Verbindungszeichenfolge für Speicherkonto. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

Eigenschaft Wert
Parametergruppe: Storage Account Arguments
--destination-path

Das Verzeichnis, in das die Quelldaten kopiert werden. Wenn nicht angegeben, werden Die Daten in das Stammverzeichnis kopiert.

--destination-share

Die Dateifreigabe, in die die Quelldaten kopiert werden.

--disallow-source-trailing-dot --disallow-src-trailing

Wenn true, wird der nachfolgende Punkt aus dem Quell-URI gekürzt. Standardwert ist "False".

Eigenschaft Wert
Standardwert: False
Zulässige Werte: false, true
--disallow-trailing-dot

Wenn true, wird der nachfolgende Punkt vom Ziel-URI gekürzt. Standardwert ist "False".

Eigenschaft Wert
Standardwert: False
Zulässige Werte: false, true
--dryrun

Listet die zu kopierenden Dateien und Blobs auf. Es erfolgt keine tatsächliche Datenübertragung.

Eigenschaft Wert
Standardwert: False
--file-endpoint

Speicherdatendienstendpunkt. Muss in Verbindung mit einem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Sie finden jeden primären Dienstendpunkt mit az storage account show. Umgebungsvariable: AZURE_STORAGE_SERVICE_ENDPOINT.

Eigenschaft Wert
Parametergruppe: Storage Account Arguments
--metadata

Metadaten in durch Leerzeichen getrennten Schlüssel-Wert-Paaren. Dadurch werden alle vorhandenen Metadaten überschrieben.

--pattern

Das Muster, das für Globbing-Dateien und Blobs verwendet wird. Die unterstützten Muster sind '*', '?', '[seq]' und '[!seq]'. Weitere Informationen finden Sie unter https://docs.python.org/3/library/fnmatch.html.

Wenn Sie '*' in --pattern verwenden, entspricht es jedem Zeichen, einschließlich des Verzeichnistrennzeichens '/'.

--sas-token

Eine freigegebene Zugriffssignatur (SAS). Muss zusammen mit dem Namen oder dem Dienstendpunkt des Speicherkontos verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

Eigenschaft Wert
Parametergruppe: Storage Account Arguments
--source-account-key

Der Kontoschlüssel für das Quellspeicherkonto. Wenn sie weggelassen wird, wird die aktive Anmeldung verwendet, um den Kontoschlüssel zu ermitteln.

Eigenschaft Wert
Parametergruppe: Copy Source Arguments
--source-account-name

Das Quellspeicherkonto, aus dem die Daten kopiert werden sollen. Wenn sie weggelassen wird, wird das Zielkonto verwendet.

Eigenschaft Wert
Parametergruppe: Copy Source Arguments
--source-container

Die Quellcontainer-Blobs werden kopiert.

Eigenschaft Wert
Parametergruppe: Copy Source Arguments
--source-sas

Die Signatur für den freigegebenen Zugriff für das Quellspeicherkonto.

Eigenschaft Wert
Parametergruppe: Copy Source Arguments
--source-share

Die Quellfreigabedateien werden kopiert.

Eigenschaft Wert
Parametergruppe: Copy Source Arguments
--source-uri

Ein URI, der eine Quelldateifreigabe oder einen BLOB-Container angibt.

Wenn sich die Quelle in einem anderen Konto befindet, muss die Quelle entweder öffentlich oder über eine freigegebene Zugriffssignatur authentifiziert werden.

Eigenschaft Wert
Parametergruppe: Copy Source Arguments
--timeout

Anforderungstimeout in Sekunden. Gilt für jeden Aufruf des Diensts.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az storage file copy start-batch (storage-preview Erweiterung)

Kopieren Sie mehrere Dateien oder Blobs in eine Dateifreigabe.

az storage file copy start-batch [--account-key]
                                 [--account-name]
                                 [--connection-string]
                                 [--destination-path]
                                 [--destination-share]
                                 [--disallow-source-trailing-dot --disallow-src-trailing {false, true}]
                                 [--disallow-trailing-dot {false, true}]
                                 [--dryrun]
                                 [--metadata]
                                 [--pattern]
                                 [--sas-token]
                                 [--source-account-key]
                                 [--source-account-name]
                                 [--source-container]
                                 [--source-sas]
                                 [--source-share]
                                 [--source-uri]
                                 [--timeout]

Beispiele

Kopieren Sie alle Dateien in einer Dateifreigabe in ein anderes Speicherkonto.

az storage file copy start-batch --source-account-name srcaccount --source-account-key 00000000 --source-share srcshare --destination-path <destpath-to-directory> --destination-share destshare --account-name destaccount --account-key 00000000

Kopieren Sie alle Dateien in einer Dateifreigabe in ein anderes Speicherkonto. mit sas-Token.

az storage file copy start-batch --source-uri "https://srcaccount.file.core.windows.net/myshare?<sastoken>" --destination-path <destpath-to-directory> --destination-share destshare --account-name destaccount --sas-token <destination-sas>

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--account-key

Speicherkontoschlüssel. Muss zusammen mit dem Namen des Speicherkontos verwendet werden. Umgebungsvariable: AZURE_STORAGE_KEY.

Eigenschaft Wert
Parametergruppe: Storage Account Arguments
--account-name

Speicherkontoname. Verwandte Umgebungsvariable: AZURE_STORAGE_ACCOUNT. Muss in Verbindung mit einem Speicherkontoschlüssel oder einem SAS-Token verwendet werden. Wenn keines vorhanden ist, versucht der Befehl, den Speicherkontoschlüssel mithilfe des authentifizierten Azure-Kontos abzufragen. Wenn eine große Anzahl von Speicherbefehlen ausgeführt wird, kann das API-Kontingent erreicht werden.

Eigenschaft Wert
Parametergruppe: Storage Account Arguments
--connection-string

Verbindungszeichenfolge für Speicherkonto. Umgebungsvariable: AZURE_STORAGE_CONNECTION_STRING.

Eigenschaft Wert
Parametergruppe: Storage Account Arguments
--destination-path

Das Verzeichnis, in das die Quelldaten kopiert werden. Wenn nicht angegeben, werden Die Daten in das Stammverzeichnis kopiert.

--destination-share

Die Dateifreigabe, in die die Quelldaten kopiert werden.

--disallow-source-trailing-dot --disallow-src-trailing

Wenn true, wird der nachfolgende Punkt aus dem Quell-URI gekürzt. Standardwert ist "False".

Eigenschaft Wert
Standardwert: False
Zulässige Werte: false, true
--disallow-trailing-dot

Wenn true, wird der nachfolgende Punkt vom Ziel-URI gekürzt. Standardwert ist "False".

Eigenschaft Wert
Standardwert: False
Zulässige Werte: false, true
--dryrun

Listet die zu kopierenden Dateien und Blobs auf. Es erfolgt keine tatsächliche Datenübertragung.

Eigenschaft Wert
Standardwert: False
--metadata

Metadaten in durch Leerzeichen getrennten Schlüssel-Wert-Paaren. Dadurch werden alle vorhandenen Metadaten überschrieben.

--pattern

Das Muster, das für Globbing-Dateien und Blobs verwendet wird. Die unterstützten Muster sind '*', '?', '[seq]' und '[!seq]'. Weitere Informationen finden Sie unter https://docs.python.org/3.7/library/fnmatch.html.

Wenn Sie '*' in --pattern verwenden, entspricht es jedem Zeichen, einschließlich des Verzeichnistrennzeichens '/'.

--sas-token

Eine freigegebene Zugriffssignatur (SAS). Muss zusammen mit dem Namen des Speicherkontos verwendet werden. Umgebungsvariable: AZURE_STORAGE_SAS_TOKEN.

Eigenschaft Wert
Parametergruppe: Storage Account Arguments
--source-account-key

Der Kontoschlüssel für das Quellspeicherkonto. Wenn sie weggelassen wird, wird die aktive Anmeldung verwendet, um den Kontoschlüssel zu ermitteln.

Eigenschaft Wert
Parametergruppe: Copy Source Arguments
--source-account-name

Das Quellspeicherkonto, aus dem die Daten kopiert werden sollen. Wenn sie weggelassen wird, wird das Zielkonto verwendet.

Eigenschaft Wert
Parametergruppe: Copy Source Arguments
--source-container

Die Quellcontainer-Blobs werden kopiert.

Eigenschaft Wert
Parametergruppe: Copy Source Arguments
--source-sas

Die Signatur für den freigegebenen Zugriff für das Quellspeicherkonto.

Eigenschaft Wert
Parametergruppe: Copy Source Arguments
--source-share

Die Quellfreigabedateien werden kopiert.

Eigenschaft Wert
Parametergruppe: Copy Source Arguments
--source-uri

Ein URI, der eine Quelldateifreigabe oder einen BLOB-Container angibt.

Wenn sich die Quelle in einem anderen Konto befindet, muss die Quelle entweder öffentlich oder über eine freigegebene Zugriffssignatur authentifiziert werden.

Eigenschaft Wert
Parametergruppe: Copy Source Arguments
--timeout

Anforderungstimeout in Sekunden. Gilt für jeden Aufruf des Diensts.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False