az storage file copy
注意
此命令群組具有 Azure CLI 和至少一個擴充功能中定義的命令。 安裝每個擴充功能以受益於其擴充功能。 深入了解擴充功能。
管理檔案複製作業。
命令
名稱 | Description | 類型 | 狀態 |
---|---|---|---|
az storage file copy cancel |
中止進行中的複製作業。 |
核心 | GA |
az storage file copy cancel (storage-preview 擴充功能) |
中止進行中的複製作業。 |
副檔名 | GA |
az storage file copy start |
以異步方式複製檔案。 |
核心 | GA |
az storage file copy start (storage-preview 擴充功能) |
以異步方式複製檔案。 |
副檔名 | GA |
az storage file copy start-batch |
將多個檔案或 Blob 複製到檔案共用。 |
核心 | GA |
az storage file copy start-batch (storage-preview 擴充功能) |
將多個檔案或 Blob 複製到檔案共用。 |
副檔名 | GA |
az storage file copy cancel
中止進行中的複製作業。
這會讓目的地檔案保持零長度和完整元數據。 如果複製作業已經結束,就會引發錯誤。
az storage file copy cancel --copy-id
--destination-path
--destination-share
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--backup-intent]
[--connection-string]
[--disallow-trailing-dot {false, true}]
[--file-endpoint]
[--sas-token]
[--timeout]
必要參數
要中止的複製作業。 這可以是標識碼或 FileProperties 的實例。
檔案共用內檔案的路徑。
目的地共用的名稱。 共用必須存在。
選擇性參數
儲存體帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_KEY。
儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令,可能會叫用 API 配額。
執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。
與檔案的 OAuth (Azure AD) 驗證搭配使用的必要參數。 這會略過任何檔案/目錄層級許可權檢查,並根據允許的數據動作允許存取,即使這些檔案/目錄有 ACL。
記憶體帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。
如果為 true,則會從目標 URI 修剪尾端點。 預設值為 False。
記憶體數據服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show
。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。
共用存取簽章 (SAS)。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。
要求以秒為單位的逾時。 適用於服務的每個呼叫。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az storage file copy cancel (storage-preview 擴充功能)
中止進行中的複製作業。
這會讓目的地檔案保持零長度和完整元數據。 如果複製作業已經結束,就會引發錯誤。
az storage file copy cancel --copy-id
--destination-path
--destination-share
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--backup-intent]
[--connection-string]
[--disallow-trailing-dot {false, true}]
[--sas-token]
[--timeout]
必要參數
要中止的複製作業。 這可以是標識碼或 FileProperties 的實例。
檔案共用內檔案的路徑。
目的地共用的名稱。 共用必須存在。
選擇性參數
儲存體帳戶金鑰。 必須與記憶體帳戶名稱搭配使用。 環境變數:AZURE_STORAGE_KEY。
儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令,可能會叫用 API 配額。
執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。
與檔案的 OAuth (Azure AD) 驗證搭配使用的必要參數。 這會略過任何檔案/目錄層級許可權檢查,並根據允許的數據動作允許存取,即使這些檔案/目錄有 ACL。
記憶體帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。
如果為 true,則會從目標 URI 修剪尾端點。 預設值為 False。
共用存取簽章 (SAS)。 必須與記憶體帳戶名稱搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。
要求以秒為單位的逾時。 適用於服務的每個呼叫。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az storage file copy start
以異步方式複製檔案。
az storage file copy start --destination-path
--destination-share
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--backup-intent]
[--connection-string]
[--disallow-source-trailing-dot {false, true}]
[--disallow-trailing-dot {false, true}]
[--file-endpoint]
[--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>
必要參數
檔案共用內檔案的路徑。
目的地共用的名稱。 共用必須存在。
選擇性參數
儲存體帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_KEY。
儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令,可能會叫用 API 配額。
執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。
與檔案的 OAuth (Azure AD) 驗證搭配使用的必要參數。 這會略過任何檔案/目錄層級許可權檢查,並根據允許的數據動作允許存取,即使這些檔案/目錄有 ACL。
記憶體帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。
如果為 true,則會從來源 URI 修剪尾端點。 預設值為 False。
如果為 true,則會從目標 URI 修剪尾端點。 預設值為 False。
記憶體數據服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show
。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。
來源記憶體帳戶的檔案快照集。
空格分隔索引鍵=值組中的元數據。 這會覆寫任何現有的元數據。
共用存取簽章 (SAS)。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。
來源 Blob 的記憶體帳戶金鑰。
來源 Blob 的記憶體帳戶名稱。
來源記憶體帳戶的 Blob 名稱。
來源記憶體帳戶的容器名稱。
來源記憶體帳戶的檔案路徑。
來源記憶體帳戶的共用存取簽章。
來源記憶體帳戶的共享名稱。
來源記憶體帳戶的 Blob 快照集。
長度最多 2 KB 的 URL,指定 Azure 檔案或 Blob。 此值應該以 URL 編碼,因為它會出現在要求 URI 中。 如果來源位於另一個帳戶中,來源必須是公用或必須透過共用存取簽章進行驗證。 如果來源是公用的,則不需要驗證。 範例: https://myaccount.file.core.windows.net/myshare/mydir/myfile https://otheraccount.file.core.windows.net/myshare/mydir/myfile?sastoken。
要求以秒為單位的逾時。 適用於服務的每個呼叫。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az storage file copy start (storage-preview 擴充功能)
以異步方式複製檔案。
az storage file copy start --destination-path
--destination-share
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--backup-intent]
[--connection-string]
[--disallow-source-trailing-dot {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>
必要參數
檔案共用內檔案的路徑。
目的地共用的名稱。 共用必須存在。
選擇性參數
儲存體帳戶金鑰。 必須與記憶體帳戶名稱搭配使用。 環境變數:AZURE_STORAGE_KEY。
儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令,可能會叫用 API 配額。
執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。
與檔案的 OAuth (Azure AD) 驗證搭配使用的必要參數。 這會略過任何檔案/目錄層級許可權檢查,並根據允許的數據動作允許存取,即使這些檔案/目錄有 ACL。
記憶體帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。
如果為 true,則會從來源 URI 修剪尾端點。 預設值為 False。
如果為 true,則會從目標 URI 修剪尾端點。 預設值為 False。
來源記憶體帳戶的檔案快照集。
空格分隔索引鍵=值組中的元數據。 這會覆寫任何現有的元數據。
共用存取簽章 (SAS)。 必須與記憶體帳戶名稱搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。
來源 Blob 的記憶體帳戶金鑰。
來源 Blob 的記憶體帳戶名稱。
來源記憶體帳戶的 Blob 名稱。
來源記憶體帳戶的容器名稱。
來源記憶體帳戶的檔案路徑。
來源記憶體帳戶的共用存取簽章。
來源記憶體帳戶的共享名稱。
來源記憶體帳戶的 Blob 快照集。
長度最多 2 KB 的 URL,指定 Azure 檔案或 Blob。 此值應該以 URL 編碼,因為它會出現在要求 URI 中。 如果來源位於另一個帳戶中,來源必須是公用或必須透過共用存取簽章進行驗證。 如果來源是公用的,則不需要驗證。 範例: https://myaccount.file.core.windows.net/myshare/mydir/myfile https://otheraccount.file.core.windows.net/myshare/mydir/myfile?sastoken。
要求以秒為單位的逾時。 適用於服務的每個呼叫。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az storage file copy start-batch
將多個檔案或 Blob 複製到檔案共用。
az storage file copy start-batch [--account-key]
[--account-name]
[--connection-string]
[--destination-path]
[--destination-share]
[--disallow-source-trailing-dot {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>
選擇性參數
儲存體帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_KEY。
儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令,可能會叫用 API 配額。
記憶體帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。
源數據複製到其中的目錄。 如果省略,則會將數據複製到根目錄。
將源數據複製到其中的檔案共用。
如果為 true,則會從來源 URI 修剪尾端點。 預設值為 False。
如果為 true,則會從目標 URI 修剪尾端點。 預設值為 False。
列出要複製的檔案和 Blob。 不會進行實際的數據傳輸。
記憶體數據服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show
。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。
空格分隔索引鍵=值組中的元數據。 這會覆寫任何現有的元數據。
用於擷取檔案和 Blob 的模式。 支援的模式為 '*'、'?'、'[seq]'和 '[!seq]'。 如需詳細資訊,請參閱 https://docs.python.org/3.7/library/fnmatch.html。
當您在 --pattern 中使用 '*' 時,它會比對包含目錄分隔符 '/' 的任何字元。
共用存取簽章 (SAS)。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。
來源記憶體帳戶的帳戶的帳戶金鑰。 如果省略,則會使用作用中的登入來判斷帳戶密鑰。
要從中複製數據的來源記憶體帳戶。 如果省略,則會使用目的地帳戶。
來源容器 Blob 會從 複製。
來源記憶體帳戶的共用存取簽章。
來源共用檔案會從複製。
指定來源檔案共享或 Blob 容器的 URI。
如果來源位於另一個帳戶中,來源必須是公用或透過共用存取簽章進行驗證。
要求以秒為單位的逾時。 適用於服務的每個呼叫。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az storage file copy start-batch (storage-preview 擴充功能)
將多個檔案或 Blob 複製到檔案共用。
az storage file copy start-batch [--account-key]
[--account-name]
[--connection-string]
[--destination-path]
[--destination-share]
[--disallow-source-trailing-dot {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>
選擇性參數
儲存體帳戶金鑰。 必須與記憶體帳戶名稱搭配使用。 環境變數:AZURE_STORAGE_KEY。
儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令,可能會叫用 API 配額。
記憶體帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。
源數據複製到其中的目錄。 如果省略,則會將數據複製到根目錄。
將源數據複製到其中的檔案共用。
如果為 true,則會從來源 URI 修剪尾端點。 預設值為 False。
如果為 true,則會從目標 URI 修剪尾端點。 預設值為 False。
列出要複製的檔案和 Blob。 不會進行實際的數據傳輸。
空格分隔索引鍵=值組中的元數據。 這會覆寫任何現有的元數據。
用於擷取檔案和 Blob 的模式。 支援的模式為 '*'、'?'、'[seq]'和 '[!seq]'。 如需詳細資訊,請參閱 https://docs.python.org/3.7/library/fnmatch.html。
當您在 --pattern 中使用 '*' 時,它會比對包含目錄分隔符 '/' 的任何字元。
共用存取簽章 (SAS)。 必須與記憶體帳戶名稱搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。
來源記憶體帳戶的帳戶的帳戶金鑰。 如果省略,則會使用作用中的登入來判斷帳戶密鑰。
要從中複製數據的來源記憶體帳戶。 如果省略,則會使用目的地帳戶。
來源容器 Blob 會從 複製。
來源記憶體帳戶的共用存取簽章。
來源共用檔案會從複製。
指定來源檔案共享或 Blob 容器的 URI。
如果來源位於另一個帳戶中,來源必須是公用或透過共用存取簽章進行驗證。
要求以秒為單位的逾時。 適用於服務的每個呼叫。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。