az storage file copy

Note

這個指令群組的指令在 Azure CLI 和至少一個擴充功能中都有定義。 安裝每個擴充功能以受益於其擴充功能。 深入了解擴充功能。

管理檔案複製作業。

命令

名稱	Description	類型	狀態
az storage file copy cancel	中止進行中的複製作業。	Core	GA
az storage file copy cancel (storage-preview 擴充功能)	中止進行中的複製作業。	Extension	GA
az storage file copy start	以異步方式複製檔案。	Core	GA
az storage file copy start (storage-preview 擴充功能)	以異步方式複製檔案。	Extension	GA
az storage file copy start-batch	將多個檔案或 Blob 複製到檔案共用。	Core	GA
az storage file copy start-batch (storage-preview 擴充功能)	將多個檔案或 Blob 複製到檔案共用。	Extension	GA

az storage file copy cancel

中止進行中的複製作業。

這會讓目的地檔案保持零長度和完整元數據。 如果複製作業已經結束，就會引發錯誤。

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

必要參數

--copy-id

要中止的複製作業。 這可以是標識碼或 FileProperties 的實例。

--destination-path -p

檔案共用內檔案的路徑。

--destination-share -s

目的地共用的名稱。 共用必須存在。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--account-key

儲存體帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數：AZURE_STORAGE_KEY。

屬性	值
參數群組:	Storage Account Arguments

--account-name

儲存體帳戶名稱。 相關的環境變數：AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在，指令會嘗試用已認證的 Azure 帳號查詢儲存帳號金鑰。 如果執行大量儲存命令，可能會達到 API 配額。

屬性	值
參數群組:	Storage Account Arguments

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數，舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數：AZURE_STORAGE_AUTH_MODE。

屬性	值
接受的值:	key, login

--backup-intent --enable-file-backup-request-intent

OAuth （Azure AD） 檔案認證時必須使用的參數。 這會略過任何檔案/目錄層級許可權檢查，並根據允許的數據動作允許存取，即使這些檔案/目錄有 ACL。

屬性	值
預設值:	False

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--connection-string

儲存帳號 連接字串。 環境變數：AZURE_STORAGE_CONNECTION_STRING。

屬性	值
參數群組:	Storage Account Arguments

--disallow-trailing-dot

如果為 true，則會從目標 URI 修剪尾端點。 預設值為 False。

屬性	值
預設值:	False
接受的值:	false, true

--file-endpoint

記憶體數據服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數：AZURE_STORAGE_SERVICE_ENDPOINT。

屬性	值
參數群組:	Storage Account Arguments

--sas-token

共用存取簽章 （SAS）。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數：AZURE_STORAGE_SAS_TOKEN。

屬性	值
參數群組:	Storage Account Arguments

--timeout

要求以秒為單位的逾時。 適用於服務的每個呼叫。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az storage file copy cancel (storage-preview 擴充功能)

中止進行中的複製作業。

這會讓目的地檔案保持零長度和完整元數據。 如果複製作業已經結束，就會引發錯誤。

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

必要參數

--copy-id

要中止的複製作業。 這可以是標識碼或 FileProperties 的實例。

--destination-path -p

檔案共用內檔案的路徑。

--destination-share -s

目的地共用的名稱。 共用必須存在。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--account-key

儲存體帳戶金鑰。 必須與記憶體帳戶名稱搭配使用。 環境變數：AZURE_STORAGE_KEY。

屬性	值
參數群組:	Storage Account Arguments

--account-name

儲存體帳戶名稱。 相關的環境變數：AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在，指令會嘗試用已認證的 Azure 帳號查詢儲存帳號金鑰。 如果執行大量儲存命令，可能會達到 API 配額。

屬性	值
參數群組:	Storage Account Arguments

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數，舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數：AZURE_STORAGE_AUTH_MODE。

屬性	值
接受的值:	key, login

--backup-intent --enable-file-backup-request-intent

OAuth （Azure AD） 檔案認證時必須使用的參數。 這會略過任何檔案/目錄層級許可權檢查，並根據允許的數據動作允許存取，即使這些檔案/目錄有 ACL。

屬性	值
預設值:	False

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--connection-string

儲存帳號 連接字串。 環境變數：AZURE_STORAGE_CONNECTION_STRING。

屬性	值
參數群組:	Storage Account Arguments

--disallow-trailing-dot

如果為 true，則會從目標 URI 修剪尾端點。 預設值為 False。

屬性	值
預設值:	False
接受的值:	false, true

--sas-token

共用存取簽章 （SAS）。 必須與記憶體帳戶名稱搭配使用。 環境變數：AZURE_STORAGE_SAS_TOKEN。

屬性	值
參數群組:	Storage Account Arguments

--timeout

要求以秒為單位的逾時。 適用於服務的每個呼叫。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az storage file copy start

以異步方式複製檔案。

az storage file copy start --destination-path
                           --destination-share
                           [--account-key]
                           [--account-name]
                           [--acquire-policy-token]
                           [--auth-mode {key, login}]
                           [--backup-intent --enable-file-backup-request-intent]
                           [--change-reference]
                           [--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]

範例

以異步方式複製檔案。

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

使用 sas 令牌，以異步方式將檔案從來源 URI 複製到目的地記憶體帳戶。

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>

使用 sas 令牌，以異步方式將檔案從檔案快照集複製到目的地記憶體帳戶。

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>

使用來源檔案模式、群組、擁有者複製檔案。

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

複製具有已覆寫檔案模式、群組、擁有者的檔案。

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

必要參數

--destination-path -p

檔案共用內檔案的路徑。

--destination-share -s

目的地共用的名稱。 共用必須存在。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--account-key

儲存體帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數：AZURE_STORAGE_KEY。

屬性	值
參數群組:	Storage Account Arguments

--account-name

儲存體帳戶名稱。 相關的環境變數：AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在，指令會嘗試用已認證的 Azure 帳號查詢儲存帳號金鑰。 如果執行大量儲存命令，可能會達到 API 配額。

屬性	值
參數群組:	Storage Account Arguments

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數，舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數：AZURE_STORAGE_AUTH_MODE。

屬性	值
接受的值:	key, login

--backup-intent --enable-file-backup-request-intent

OAuth （Azure AD） 檔案認證時必須使用的參數。 這會略過任何檔案/目錄層級許可權檢查，並根據允許的數據動作允許存取，即使這些檔案/目錄有 ACL。

屬性	值
預設值:	False

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--connection-string

儲存帳號 連接字串。 環境變數：AZURE_STORAGE_CONNECTION_STRING。

屬性	值
參數群組:	Storage Account Arguments

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

如果為 true，則會從來源 URI 修剪尾端點。 預設值為 False。

屬性	值
預設值:	False
接受的值:	false, true

--disallow-trailing-dot

如果為 true，則會從目標 URI 修剪尾端點。 預設值為 False。

屬性	值
預設值:	False
接受的值:	false, true

--file-endpoint

記憶體數據服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數：AZURE_STORAGE_SERVICE_ENDPOINT。

屬性	值
參數群組:	Storage Account Arguments

--file-mode

要設定於檔案上的模式許可權。 僅適用於 NFS 檔案。 只能與 參數 --file-mode-copy-mode Override搭配使用。 支援符號 （rwxrw-rw-） 。 黏性位也受到支援，而且它是由字母 t 或 T 在最後字元位置表示，視其他類別的執行位是分別設定或未設定而定，沒有 t 或 T 表示未設定黏性位。」。

--file-mode-copy-mode

僅適用於 NFS 檔案。 僅適用於複製來源為檔案時。 決定目的地檔案之模式位的複製行為。 如果未填入，目的地檔案將會有預設的檔案模式。

屬性	值
接受的值:	override, source

--file-snapshot

來源記憶體帳戶的檔案快照集。

屬性	值
參數群組:	Copy Source Arguments

--group

僅適用於 NFS 檔案。 只能與 參數 --owner-copy-mode Override搭配使用。 要設定在目錄上的擁有者群組標識碼 （GID）。 預設值為 0 （根群組）。

--metadata

以空格分隔的鍵值對中的元數據。 這會覆寫任何現有的元數據。

--owner

僅適用於 NFS 檔案。 只能與 參數 --owner-copy-mode Override搭配使用。 要設定在目錄上的擁有者使用者標識碼 （UID）。 預設值為 0 （root）。

--owner-copy-mode

僅適用於 NFS 檔案。 僅適用於複製來源為檔案時。 決定目的地檔案擁有者和群組的複製行為。 如果未填入，目的地檔案將會有預設的擁有者和群組。

屬性	值
接受的值:	override, source

--sas-token

共用存取簽章 （SAS）。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數：AZURE_STORAGE_SAS_TOKEN。

屬性	值
參數群組:	Storage Account Arguments

--source-account-key

來源 Blob 的記憶體帳戶金鑰。

屬性	值
參數群組:	Copy Source Arguments

--source-account-name

來源 Blob 的記憶體帳戶名稱。

屬性	值
參數群組:	Copy Source Arguments

--source-blob

來源記憶體帳戶的 Blob 名稱。

屬性	值
參數群組:	Copy Source Arguments

--source-container

來源記憶體帳戶的容器名稱。

屬性	值
參數群組:	Copy Source Arguments

--source-path

來源記憶體帳戶的檔案路徑。

屬性	值
參數群組:	Copy Source Arguments

--source-sas

來源記憶體帳戶的共用存取簽章。

屬性	值
參數群組:	Copy Source Arguments

--source-share

來源記憶體帳戶的共享名稱。

屬性	值
參數群組:	Copy Source Arguments

--source-snapshot

來源記憶體帳戶的 Blob 快照集。

屬性	值
參數群組:	Copy Source Arguments

--source-uri -u

長度最多 2 KB 的 URL，指定 Azure 檔案或 blob。 此值應該以 URL 編碼，因為它會出現在要求 URI 中。 如果來源位於另一個帳戶中，來源必須是公用或必須透過共用存取簽章進行驗證。 如果來源是公用的，則不需要驗證。 範例：https://myaccount.file.core.windows.net/myshare/mydir/myfilehttps://otheraccount.file.core.windows.net/myshare/mydir/myfile?sastoken。

屬性	值
參數群組:	Copy Source Arguments

--timeout

要求以秒為單位的逾時。 適用於服務的每個呼叫。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az storage file copy start (storage-preview 擴充功能)

以異步方式複製檔案。

az storage file copy start --destination-path
                           --destination-share
                           [--account-key]
                           [--account-name]
                           [--acquire-policy-token]
                           [--auth-mode {key, login}]
                           [--backup-intent --enable-file-backup-request-intent]
                           [--change-reference]
                           [--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]

範例

以異步方式複製檔案。

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

使用 sas 令牌，以異步方式將檔案從來源 URI 複製到目的地記憶體帳戶。

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>

使用 sas 令牌，以異步方式將檔案從檔案快照集複製到目的地記憶體帳戶。

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>

必要參數

--destination-path -p

檔案共用內檔案的路徑。

--destination-share -s

目的地共用的名稱。 共用必須存在。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--account-key

儲存體帳戶金鑰。 必須與記憶體帳戶名稱搭配使用。 環境變數：AZURE_STORAGE_KEY。

屬性	值
參數群組:	Storage Account Arguments

--account-name

儲存體帳戶名稱。 相關的環境變數：AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在，指令會嘗試用已認證的 Azure 帳號查詢儲存帳號金鑰。 如果執行大量儲存命令，可能會達到 API 配額。

屬性	值
參數群組:	Storage Account Arguments

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數，舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數：AZURE_STORAGE_AUTH_MODE。

屬性	值
接受的值:	key, login

--backup-intent --enable-file-backup-request-intent

OAuth （Azure AD） 檔案認證時必須使用的參數。 這會略過任何檔案/目錄層級許可權檢查，並根據允許的數據動作允許存取，即使這些檔案/目錄有 ACL。

屬性	值
預設值:	False

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--connection-string

儲存帳號 連接字串。 環境變數：AZURE_STORAGE_CONNECTION_STRING。

屬性	值
參數群組:	Storage Account Arguments

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

如果為 true，則會從來源 URI 修剪尾端點。 預設值為 False。

屬性	值
預設值:	False
接受的值:	false, true

--disallow-trailing-dot

如果為 true，則會從目標 URI 修剪尾端點。 預設值為 False。

屬性	值
預設值:	False
接受的值:	false, true

--file-snapshot

來源記憶體帳戶的檔案快照集。

屬性	值
參數群組:	Copy Source Arguments

--metadata

以空格分隔的鍵值對中的元數據。 這會覆寫任何現有的元數據。

--sas-token

共用存取簽章 （SAS）。 必須與記憶體帳戶名稱搭配使用。 環境變數：AZURE_STORAGE_SAS_TOKEN。

屬性	值
參數群組:	Storage Account Arguments

--source-account-key

來源 Blob 的記憶體帳戶金鑰。

屬性	值
參數群組:	Copy Source Arguments

--source-account-name

來源 Blob 的記憶體帳戶名稱。

屬性	值
參數群組:	Copy Source Arguments

--source-blob

來源記憶體帳戶的 Blob 名稱。

屬性	值
參數群組:	Copy Source Arguments

--source-container

來源記憶體帳戶的容器名稱。

屬性	值
參數群組:	Copy Source Arguments

--source-path

來源記憶體帳戶的檔案路徑。

屬性	值
參數群組:	Copy Source Arguments

--source-sas

來源記憶體帳戶的共用存取簽章。

屬性	值
參數群組:	Copy Source Arguments

--source-share

來源記憶體帳戶的共享名稱。

屬性	值
參數群組:	Copy Source Arguments

--source-snapshot

來源記憶體帳戶的 Blob 快照集。

屬性	值
參數群組:	Copy Source Arguments

--source-uri -u

長度最多 2 KB 的 URL，指定 Azure 檔案或 blob。 此值應該以 URL 編碼，因為它會出現在要求 URI 中。 如果來源位於另一個帳戶中，來源必須是公用或必須透過共用存取簽章進行驗證。 如果來源是公用的，則不需要驗證。 範例：https://myaccount.file.core.windows.net/myshare/mydir/myfilehttps://otheraccount.file.core.windows.net/myshare/mydir/myfile?sastoken。

屬性	值
參數群組:	Copy Source Arguments

--timeout

要求以秒為單位的逾時。 適用於服務的每個呼叫。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az storage file copy start-batch

將多個檔案或 Blob 複製到檔案共用。

az storage file copy start-batch [--account-key]
                                 [--account-name]
                                 [--acquire-policy-token]
                                 [--change-reference]
                                 [--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]

範例

將檔案共用中的所有檔案複製到另一個記憶體帳戶。

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

將檔案共用中的所有檔案複製到另一個記憶體帳戶。 使用 sas 令牌。

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>

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--account-key

儲存體帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數：AZURE_STORAGE_KEY。

屬性	值
參數群組:	Storage Account Arguments

--account-name

儲存體帳戶名稱。 相關的環境變數：AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在，指令會嘗試用已認證的 Azure 帳號查詢儲存帳號金鑰。 如果執行大量儲存命令，可能會達到 API 配額。

屬性	值
參數群組:	Storage Account Arguments

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--connection-string

儲存帳號 連接字串。 環境變數：AZURE_STORAGE_CONNECTION_STRING。

屬性	值
參數群組:	Storage Account Arguments

--destination-path

源數據複製到其中的目錄。 如果省略，則會將數據複製到根目錄。

--destination-share

將源數據複製到其中的檔案共用。

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

如果為 true，則會從來源 URI 修剪尾端點。 預設值為 False。

屬性	值
預設值:	False
接受的值:	false, true

--disallow-trailing-dot

如果為 true，則會從目標 URI 修剪尾端點。 預設值為 False。

屬性	值
預設值:	False
接受的值:	false, true

--dryrun

列出要複製的檔案和 Blob。 不會進行實際的數據傳輸。

屬性	值
預設值:	False

--file-endpoint

記憶體數據服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數：AZURE_STORAGE_SERVICE_ENDPOINT。

屬性	值
參數群組:	Storage Account Arguments

--metadata

以空格分隔的鍵值對中的元數據。 這會覆寫任何現有的元數據。

--pattern

用於擷取檔案和 Blob 的模式。 支援的模式為 '*'、'？'、'[seq]'和 '[！seq]'。 如需詳細資訊，請參閱 https://docs.python.org/3/library/fnmatch.html。

當您在 --pattern 中使用 '*' 時，它會比對包含目錄分隔符 '/' 的任何字元。

--sas-token

共用存取簽章 （SAS）。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數：AZURE_STORAGE_SAS_TOKEN。

屬性	值
參數群組:	Storage Account Arguments

--source-account-key

來源記憶體帳戶的帳戶的帳戶金鑰。 如果省略，則會使用作用中的登入來判斷帳戶密鑰。

屬性	值
參數群組:	Copy Source Arguments

--source-account-name

要從中複製數據的來源記憶體帳戶。 如果省略，則會使用目的地帳戶。

屬性	值
參數群組:	Copy Source Arguments

--source-container

來源容器 Blob 會從 複製。

屬性	值
參數群組:	Copy Source Arguments

--source-sas

來源記憶體帳戶的共用存取簽章。

屬性	值
參數群組:	Copy Source Arguments

--source-share

來源共用檔案會從複製。

屬性	值
參數群組:	Copy Source Arguments

--source-uri

指定來源檔案共享或 Blob 容器的 URI。

如果來源位於另一個帳戶中，來源必須是公用或透過共用存取簽章進行驗證。

屬性	值
參數群組:	Copy Source Arguments

--timeout

要求以秒為單位的逾時。 適用於服務的每個呼叫。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az storage file copy start-batch (storage-preview 擴充功能)

將多個檔案或 Blob 複製到檔案共用。

az storage file copy start-batch [--account-key]
                                 [--account-name]
                                 [--acquire-policy-token]
                                 [--change-reference]
                                 [--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]

範例

將檔案共用中的所有檔案複製到另一個記憶體帳戶。

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

將檔案共用中的所有檔案複製到另一個記憶體帳戶。 使用 sas 令牌。

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>

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--account-key

儲存體帳戶金鑰。 必須與記憶體帳戶名稱搭配使用。 環境變數：AZURE_STORAGE_KEY。

屬性	值
參數群組:	Storage Account Arguments

--account-name

儲存體帳戶名稱。 相關的環境變數：AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在，指令會嘗試用已認證的 Azure 帳號查詢儲存帳號金鑰。 如果執行大量儲存命令，可能會達到 API 配額。

屬性	值
參數群組:	Storage Account Arguments

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性	值
參數群組:	Global Policy Arguments

--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性	值
參數群組:	Global Policy Arguments

--connection-string

儲存帳號 連接字串。 環境變數：AZURE_STORAGE_CONNECTION_STRING。

屬性	值
參數群組:	Storage Account Arguments

--destination-path

源數據複製到其中的目錄。 如果省略，則會將數據複製到根目錄。

--destination-share

將源數據複製到其中的檔案共用。

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

如果為 true，則會從來源 URI 修剪尾端點。 預設值為 False。

屬性	值
預設值:	False
接受的值:	false, true

--disallow-trailing-dot

如果為 true，則會從目標 URI 修剪尾端點。 預設值為 False。

屬性	值
預設值:	False
接受的值:	false, true

--dryrun

列出要複製的檔案和 Blob。 不會進行實際的數據傳輸。

屬性	值
預設值:	False

--metadata

以空格分隔的鍵值對中的元數據。 這會覆寫任何現有的元數據。

--pattern

用於擷取檔案和 Blob 的模式。 支援的模式為 '*'、'？'、'[seq]'和 '[！seq]'。 如需詳細資訊，請參閱 https://docs.python.org/3.7/library/fnmatch.html。

當您在 --pattern 中使用 '*' 時，它會比對包含目錄分隔符 '/' 的任何字元。

--sas-token

共用存取簽章 （SAS）。 必須與記憶體帳戶名稱搭配使用。 環境變數：AZURE_STORAGE_SAS_TOKEN。

屬性	值
參數群組:	Storage Account Arguments

--source-account-key

來源記憶體帳戶的帳戶的帳戶金鑰。 如果省略，則會使用作用中的登入來判斷帳戶密鑰。

屬性	值
參數群組:	Copy Source Arguments

--source-account-name

要從中複製數據的來源記憶體帳戶。 如果省略，則會使用目的地帳戶。

屬性	值
參數群組:	Copy Source Arguments

--source-container

來源容器 Blob 會從 複製。

屬性	值
參數群組:	Copy Source Arguments

--source-sas

來源記憶體帳戶的共用存取簽章。

屬性	值
參數群組:	Copy Source Arguments

--source-share

來源共用檔案會從複製。

屬性	值
參數群組:	Copy Source Arguments

--source-uri

指定來源檔案共享或 Blob 容器的 URI。

如果來源位於另一個帳戶中，來源必須是公用或透過共用存取簽章進行驗證。

屬性	值
參數群組:	Copy Source Arguments

--timeout

要求以秒為單位的逾時。 適用於服務的每個呼叫。

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False