Share via


az storage file

注意

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

管理使用SMB 3.0通訊協定的檔案共用。

命令

名稱 Description 類型 狀態
az storage file copy

管理檔案複製作業。

核心和擴充功能 GA
az storage file copy cancel

中止進行中的複製作業。

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

中止進行中的複製作業。

副檔名 預覽版
az storage file copy start

以異步方式複製檔案。

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

以異步方式複製檔案。

副檔名 預覽版
az storage file copy start-batch

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

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

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

副檔名 預覽版
az storage file delete

標示要刪除的指定檔案。

核心 GA
az storage file delete (storage-preview 擴充功能)

標示要刪除的指定檔案。

副檔名 預覽版
az storage file delete-batch

從 Azure 儲存體 檔案共享中刪除檔案。

核心 GA
az storage file delete-batch (storage-preview 擴充功能)

從 Azure 儲存體 檔案共享中刪除檔案。

副檔名 預覽版
az storage file download

使用自動區塊化和進度通知,將檔案下載至檔案路徑。

核心 GA
az storage file download (storage-preview 擴充功能)

使用自動區塊化和進度通知,將檔案下載至檔案路徑。

副檔名 預覽版
az storage file download-batch

將檔案從 Azure 儲存體 檔案共享下載到批次作業中的本機目錄。

核心 GA
az storage file download-batch (storage-preview 擴充功能)

將檔案從 Azure 儲存體 檔案共享下載到批次作業中的本機目錄。

副檔名 預覽版
az storage file exists

檢查檔案是否存在。

核心 GA
az storage file exists (storage-preview 擴充功能)

檢查檔案是否存在。

副檔名 預覽版
az storage file generate-sas

產生檔案的共用存取簽章。

核心 GA
az storage file generate-sas (storage-preview 擴充功能)

產生檔案的共用存取簽章。

副檔名 預覽版
az storage file list

列出共用中的檔案和目錄。

核心 GA
az storage file list (storage-preview 擴充功能)

列出共用中的檔案和目錄。

副檔名 預覽版
az storage file metadata

管理檔案元數據。

核心和擴充功能 GA
az storage file metadata show

傳回檔案的所有用戶定義元數據。

核心 GA
az storage file metadata show (storage-preview 擴充功能)

傳回檔案的所有用戶定義元數據。

副檔名 預覽版
az storage file metadata update

更新檔案元數據。

核心 GA
az storage file metadata update (storage-preview 擴充功能)

更新檔案元數據。

副檔名 預覽版
az storage file resize

將檔案大小調整為指定的大小。

核心 GA
az storage file resize (storage-preview 擴充功能)

將檔案大小調整為指定的大小。

副檔名 預覽版
az storage file show

傳回檔案的所有使用者定義元數據、標準 HTTP 屬性和系統屬性。

核心 GA
az storage file show (storage-preview 擴充功能)

傳回檔案的所有使用者定義元數據、標準 HTTP 屬性和系統屬性。

副檔名 預覽版
az storage file update

在檔案上設定系統屬性。

核心 GA
az storage file update (storage-preview 擴充功能)

在檔案上設定系統屬性。

副檔名 預覽版
az storage file upload

將檔案上傳至使用SMB 3.0通訊協議的共用。

核心 GA
az storage file upload (storage-preview 擴充功能)

將檔案上傳至使用SMB 3.0通訊協議的共用。

副檔名 預覽版
az storage file upload-batch

將檔案從本機目錄上傳至批次作業中的 Azure 儲存體 檔案共用。

核心 GA
az storage file upload-batch (storage-preview 擴充功能)

將檔案從本機目錄上傳至批次作業中的 Azure 儲存體 檔案共用。

副檔名 預覽版
az storage file url

建立 URL 以存取檔案。

核心 GA
az storage file url (storage-preview 擴充功能)

建立 URL 以存取檔案。

副檔名 預覽版

az storage file delete

標示要刪除的指定檔案。

檔案稍後會在垃圾收集期間刪除。

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

必要參數

--path -p

檔案共用內檔案的路徑。

--share-name -s

檔案共享名稱。

選擇性參數

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

與檔案的 OAuth (Azure AD) 驗證搭配使用的必要參數。 這會略過任何檔案/目錄層級許可權檢查,並根據允許的數據動作允許存取,即使這些檔案/目錄有 ACL。

預設值: False
--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

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

接受的值: false, true
預設值: False
--file-endpoint

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

--sas-token

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

--timeout

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

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage file delete (storage-preview 擴充功能)

預覽

命令群組 『az storage』 處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

標示要刪除的指定檔案。

檔案稍後會在垃圾收集期間刪除。

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

必要參數

--path -p

檔案共用內檔案的路徑。

--share-name -s

檔案共享名稱。

選擇性參數

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

與檔案的 OAuth (Azure AD) 驗證搭配使用的必要參數。 這會略過任何檔案/目錄層級許可權檢查,並根據允許的數據動作允許存取,即使這些檔案/目錄有 ACL。

預設值: False
--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

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

接受的值: false, true
預設值: False
--sas-token

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

--timeout

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

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage file delete-batch

從 Azure 儲存體 檔案共享中刪除檔案。

az storage file delete-batch --source
                             [--account-key]
                             [--account-name]
                             [--auth-mode {key, login}]
                             [--backup-intent]
                             [--connection-string]
                             [--disallow-trailing-dot {false, true}]
                             [--dryrun]
                             [--file-endpoint]
                             [--pattern]
                             [--sas-token]
                             [--timeout]

範例

從 Azure 儲存體 檔案共享中刪除檔案。 ( 自動產生 )

az storage file delete-batch --account-key 00000000 --account-name MyAccount --source /path/to/file

從檔案共用 Azure 儲存體 刪除檔案。 ( 自動產生 )

az storage file delete-batch --account-key 00000000 --account-name MyAccount --pattern "*.py" --source /path/to/file

必要參數

--source -s

檔案刪除作業的來源。 來源可以是檔案共享URL或共享名稱。

選擇性參數

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

與檔案的 OAuth (Azure AD) 驗證搭配使用的必要參數。 這會略過任何檔案/目錄層級許可權檢查,並根據允許的數據動作允許存取,即使這些檔案/目錄有 ACL。

預設值: False
--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

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

接受的值: false, true
預設值: False
--dryrun

列出要刪除的檔案和 Blob。 不會發生實際的數據刪除。

預設值: False
--file-endpoint

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

--pattern

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

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

--sas-token

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

--timeout

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

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

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

預覽

命令群組 『az storage』 處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

從檔案共用 Azure 儲存體 刪除檔案。

az storage file delete-batch --source
                             [--account-key]
                             [--account-name]
                             [--auth-mode {key, login}]
                             [--backup-intent]
                             [--connection-string]
                             [--disallow-trailing-dot {false, true}]
                             [--dryrun]
                             [--pattern]
                             [--sas-token]
                             [--timeout]

範例

從 Azure 儲存體 檔案共享中刪除檔案。 ( 自動產生 )

az storage file delete-batch --account-key 00000000 --account-name MyAccount --source /path/to/file

從 Azure 儲存體 檔案共享中刪除檔案。 ( 自動產生 )

az storage file delete-batch --account-key 00000000 --account-name MyAccount --pattern *.py --source /path/to/file

必要參數

--source -s

檔案刪除作業的來源。 來源可以是檔案共享URL或共享名稱。

選擇性參數

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

與檔案的 OAuth (Azure AD) 驗證搭配使用的必要參數。 這會略過任何檔案/目錄層級許可權檢查,並根據允許的數據動作允許存取,即使這些檔案/目錄有 ACL。

預設值: False
--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

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

接受的值: false, true
預設值: False
--dryrun

列出要刪除的檔案和 Blob。 不會發生實際的數據刪除。

預設值: False
--pattern

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

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

--sas-token

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

--timeout

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

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage file download

使用自動區塊化和進度通知,將檔案下載至檔案路徑。

傳回具有屬性和元數據的 File 實例。

az storage file download --path
                         --share-name
                         [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--backup-intent]
                         [--connection-string]
                         [--dest]
                         [--disallow-trailing-dot {false, true}]
                         [--end-range]
                         [--file-endpoint]
                         [--max-connections]
                         [--no-progress]
                         [--open-mode]
                         [--sas-token]
                         [--snapshot]
                         [--start-range]
                         [--timeout]
                         [--validate-content]

必要參數

--path -p

檔案共用內檔案的路徑。

--share-name -s

檔案共用名稱稱。

選擇性參數

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

與檔案的 OAuth (Azure AD) 驗證搭配使用的必要參數。 這會略過任何檔案/目錄層級許可權檢查,並根據允許的數據動作允許存取,即使這些檔案/目錄有 ACL。

預設值: False
--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--dest

要寫入之檔案的路徑。 如果未指定,則會使用來源檔名。

--disallow-trailing-dot

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

接受的值: false, true
預設值: False
--end-range

要用來下載檔案區段的位元組範圍結尾。 如果指定 --end-range,則必須提供 --start-range。 --start-range 和 --end-range 參數包含。 例如:--start-range=0,--end-range=511 將下載前 512 個字節的檔案。

--file-endpoint

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

--max-connections

要使用的平行連線數目上限。

預設值: 2
--no-progress

包含此旗標以停用命令的進度報告。

預設值: False
--open-mode

開啟檔案時要使用的模式。 請注意,只指定附加open_mode可防止平行下載。 因此,如果使用這個 --open-mode,則必須將 --max-connections 設定為 1。

預設值: wb
--sas-token

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

--snapshot

表示快照集版本的字串,如果適用的話。

--start-range

要用來下載檔案區段的位元組範圍開始。 如果未指定 --end-range,則會下載 --start-range 之後的所有位元組。 --start-range 和 --end-range 參數包含。 例如:--start-range=0,--end-range=511 將下載前 512 個字節的檔案。

--timeout

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

--validate-content

如果設定為 true,則會驗證檔案中每個擷取部分的 MD5 哈希。 如果使用 HTTP 而非 HTTPs 作為 HTTPs,這主要對於偵測網路上的 bitflip 相當有價值(預設值)已經驗證。 由於區塊大小減少,因此計算 MD5 需要處理時間,而且需要執行更多要求,延遲可能會增加一些。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage file download (storage-preview 擴充功能)

預覽

命令群組 'az storage' 處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

使用自動區塊化和進度通知,將檔案下載至檔案路徑。

傳回具有屬性和中繼資料的 File 實例。

az storage file download --path
                         --share-name
                         [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--backup-intent]
                         [--connection-string]
                         [--dest]
                         [--disallow-trailing-dot {false, true}]
                         [--end-range]
                         [--max-connections]
                         [--no-progress]
                         [--open-mode]
                         [--sas-token]
                         [--snapshot]
                         [--start-range]
                         [--timeout]
                         [--validate-content]

必要參數

--path -p

檔案共用內檔案的路徑。

--share-name -s

檔案共用名稱稱。

選擇性參數

--account-key

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

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與儲存體帳戶金鑰或 SAS 權杖搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢儲存體帳戶金鑰。 如果執行大量儲存體命令,可能會叫用 API 配額。

--auth-mode

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

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

與檔案的 OAuth (Azure AD) 驗證搭配使用的必要參數。 這會略過任何檔案/目錄層級許可權檢查,並根據允許的資料動作允許存取,即使這些檔案/目錄有 ACL。

預設值: False
--connection-string

儲存體帳戶連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--dest

要寫入之檔案的路徑。 如果未指定,則會使用來原始檔案名。

--disallow-trailing-dot

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

接受的值: false, true
預設值: False
--end-range

要用來下載檔案區段的位元組範圍結尾。 如果指定 --end-range,則必須提供 --start-range。 --start-range 和 --end-range 參數包含。 例如:--start-range=0,--end-range=511 將下載前 512 個位元組的檔案。

--max-connections

要使用的平行連線數目上限。

預設值: 2
--no-progress

包含此旗標以停用命令的進度報告。

預設值: False
--open-mode

開啟檔案時要使用的模式。 請注意,只指定附加open_mode可防止平行下載。 因此,如果使用這個 --open-mode,則必須將 --max-connections 設定為 1。

預設值: wb
--sas-token

共用存取簽章 (SAS)。 必須與儲存體帳戶名稱搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

--snapshot

表示快照集版本的字串,如果適用的話。

--start-range

要用來下載檔案區段的位元組範圍開始。 如果未指定 --end-range,則會下載 --start-range 之後的所有位元組。 --start-range 和 --end-range 參數包含。 例如:--start-range=0,--end-range=511 將下載前 512 個位元組的檔案。

--timeout

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

--validate-content

如果設定為 true,則會驗證檔案中每個擷取部分的 MD5 雜湊。 如果使用 HTTP 而非 HTTPs 作為 HTTPs,這主要對於偵測網路上的 bitflip 相當有價值(預設值)已經驗證。 由於區塊大小減少,因此計算 MD5 需要處理時間,而且需要執行更多要求,延遲可能會增加一些。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage file download-batch

將檔案從Azure 儲存體檔案共用下載到批次作業中的本機目錄。

az storage file download-batch --destination
                               --source
                               [--account-key]
                               [--account-name]
                               [--connection-string]
                               [--disallow-trailing-dot {false, true}]
                               [--dryrun]
                               [--file-endpoint]
                               [--max-connections]
                               [--no-progress]
                               [--pattern]
                               [--sas-token]
                               [--snapshot]
                               [--validate-content]

範例

將檔案從Azure 儲存體檔案共用下載到批次作業中的本機目錄。 (自動產生)

az storage file download-batch --account-key 00000000 --account-name MyAccount --destination . --no-progress --source /path/to/file

必要參數

--destination -d

下載檔案的本機目錄。 此目錄必須已經存在。

--source -s

檔案下載作業的來源。 來源可以是檔案共用 URL 或共用名稱稱。

選擇性參數

--account-key

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

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與儲存體帳戶金鑰或 SAS 權杖搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢儲存體帳戶金鑰。 如果執行大量儲存體命令,可能會叫用 API 配額。

--connection-string

儲存體帳戶連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

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

接受的值: false, true
預設值: False
--dryrun

列出要下載的檔案和 Blob。 不會進行實際的資料傳輸。

預設值: False
--file-endpoint

儲存體資料服務端點。 必須與儲存體帳戶金鑰或 SAS 權杖搭配使用。 您可以使用 找到每個服務主要端點 az storage account show 。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。

--max-connections

要使用的平行連線數目上限。 預設值為 1。

預設值: 1
--no-progress

包含此旗標以停用命令的進度報告。

預設值: False
--pattern

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

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

--sas-token

共用存取簽章 (SAS)。 必須與儲存體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

--snapshot

表示快照集版本的字串,如果適用的話。

--validate-content

如果已設定,則計算檔案每個範圍的 MD5 雜湊以進行驗證。

儲存體服務會檢查已抵達之內容的雜湊,與已傳送的雜湊相同。 如果使用 HTTP 而不是 HTTPS,在傳輸期間偵測 bitflip,這最有價值。 此雜湊不會儲存。

預設值: False
全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

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

預覽

命令群組 'az storage' 處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

將檔案從Azure 儲存體檔案共用下載到批次作業中的本機目錄。

az storage file download-batch --destination
                               --source
                               [--account-key]
                               [--account-name]
                               [--connection-string]
                               [--disallow-trailing-dot {false, true}]
                               [--dryrun]
                               [--max-connections]
                               [--no-progress]
                               [--pattern]
                               [--sas-token]
                               [--snapshot]
                               [--validate-content]

範例

將檔案從Azure 儲存體檔案共用下載到批次作業中的本機目錄。 (自動產生)

az storage file download-batch --account-key 00000000 --account-name MyAccount --destination . --no-progress --source /path/to/file

必要參數

--destination -d

下載檔案的本機目錄。 此目錄必須已經存在。

--source -s

檔案下載作業的來源。 來源可以是檔案共用 URL 或共用名稱稱。

選擇性參數

--account-key

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

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與儲存體帳戶金鑰或 SAS 權杖搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢儲存體帳戶金鑰。 如果執行大量儲存體命令,可能會叫用 API 配額。

--connection-string

儲存體帳戶連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

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

接受的值: false, true
預設值: False
--dryrun

列出要下載的檔案和 Blob。 不會進行實際的資料傳輸。

預設值: False
--max-connections

要使用的平行連線數目上限。 預設值為 1。

預設值: 1
--no-progress

包含此旗標以停用命令的進度報告。

預設值: False
--pattern

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

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

--sas-token

共用存取簽章 (SAS)。 必須與儲存體帳戶名稱搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

--snapshot

表示快照集版本的字串,如果適用的話。

--validate-content

如果已設定,則計算檔案每個範圍的 MD5 雜湊以進行驗證。

儲存體服務會檢查已抵達之內容的雜湊,與已傳送的雜湊相同。 如果使用 HTTP 而不是 HTTPS,在傳輸期間偵測 bitflip,這最有價值。 此雜湊不會儲存。

預設值: False
全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage file exists

檢查檔案是否存在。

az storage file exists --path
                       --share-name
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--backup-intent]
                       [--connection-string]
                       [--disallow-trailing-dot {false, true}]
                       [--file-endpoint]
                       [--sas-token]
                       [--snapshot]
                       [--timeout]

範例

檢查檔案是否存在。 ( 自動產生 )

az storage file exists --account-key 00000000 --account-name MyAccount --path path/file.txt --share-name MyShare

檢查檔案是否存在。 ( 自動產生 )

az storage file exists --connection-string $connectionString --path path/file.txt --share-name MyShare

必要參數

--path -p

檔案共用內檔案的路徑。

--share-name -s

檔案共享名稱。

選擇性參數

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

與檔案的 OAuth (Azure AD) 驗證搭配使用的必要參數。 這會略過任何檔案/目錄層級許可權檢查,並根據允許的數據動作允許存取,即使這些檔案/目錄有 ACL。

預設值: False
--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

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

接受的值: false, true
預設值: False
--file-endpoint

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

--sas-token

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

--snapshot

表示快照集版本的字串,如果適用的話。

--timeout

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

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage file exists (storage-preview 擴充功能)

預覽

命令群組 『az storage』 處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

檢查檔案是否存在。

az storage file exists --path
                       --share-name
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--backup-intent]
                       [--connection-string]
                       [--disallow-trailing-dot {false, true}]
                       [--sas-token]
                       [--snapshot]
                       [--timeout]

範例

檢查檔案是否存在。 ( 自動產生 )

az storage file exists --account-key 00000000 --account-name MyAccount --path path/file.txt --share-name MyShare

檢查檔案是否存在。 ( 自動產生 )

az storage file exists --connection-string $connectionString --path path/file.txt --share-name MyShare

必要參數

--path -p

檔案共用內檔案的路徑。

--share-name -s

檔案共享名稱。

選擇性參數

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

與檔案的 OAuth (Azure AD) 驗證搭配使用的必要參數。 這會略過任何檔案/目錄層級許可權檢查,並根據允許的數據動作允許存取,即使這些檔案/目錄有 ACL。

預設值: False
--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

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

接受的值: false, true
預設值: False
--sas-token

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

--snapshot

表示快照集版本的字串,如果適用的話。

--timeout

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

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage file generate-sas

產生檔案的共用存取簽章。

az storage file generate-sas --path
                             --share-name
                             [--account-key]
                             [--account-name]
                             [--cache-control]
                             [--connection-string]
                             [--content-disposition]
                             [--content-encoding]
                             [--content-language]
                             [--content-type]
                             [--disallow-trailing-dot {false, true}]
                             [--expiry]
                             [--file-endpoint]
                             [--https-only]
                             [--ip]
                             [--permissions]
                             [--policy-name]
                             [--start]

範例

產生檔案的SAS令牌。

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage file generate-sas -p path/file.txt -s MyShare --account-name MyStorageAccount --permissions rcdw --https-only --expiry $end

產生檔案的共用存取簽章。 ( 自動產生 )

az storage file generate-sas --account-name MyStorageAccount --expiry 2037-12-31T23:59:00Z --path path/file.txt --permissions rcdw --share-name MyShare --start 2019-01-01T12:20Z

產生檔案的共用存取簽章。 ( 自動產生 )

az storage file generate-sas --account-key 00000000 --account-name mystorageaccount --expiry 2037-12-31T23:59:00Z --https-only --path path/file.txt --permissions rcdw --share-name myshare

必要參數

--path -p

檔案共用內檔案的路徑。

--share-name -s

檔案共用名稱稱。

選擇性參數

--account-key

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

--account-name

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

--cache-control

當使用此共用存取簽章存取資源時,Cache-Control 的響應標頭值。

--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--content-disposition

當使用此共用存取簽章存取資源時,Content-Disposition 的響應標頭值。

--content-encoding

使用此共用存取簽章存取資源時,Content-Encoding 的響應標頭值。

--content-language

使用此共用存取簽章存取資源時,Content-Language 的響應標頭值。

--content-type

當使用此共用存取簽章存取資源時,Content-Type 的回應標頭值。

--disallow-trailing-dot

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

接受的值: false, true
預設值: False
--expiry

指定 SAS 不正確 UTC 日期時間(Y-m-d'T'H:M'Z')。 如果以指定此值的 --policy-name 參考預存存取原則,請勿使用 。

--file-endpoint

儲存體資料服務端點。 必須與儲存體帳戶金鑰或 SAS 權杖搭配使用。 您可以使用 找到每個服務主要端點 az storage account show 。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。

--https-only

只允許使用 HTTPS 通訊協定提出的要求。 如果省略,則允許來自 HTTP 和 HTTPS 通訊協定的要求。

--ip

指定要接受要求的 IP 位址或 IP 位址範圍。 僅支援 IPv4 樣式位址。

--permissions

SAS 授與的許可權。 允許的值: (c)reate (d)elete (r)ead (w)rite. 如果以指定此值的 --id 參考預存存取原則,請勿使用 。 可以合併。

--policy-name

容器 ACL 內預存存取原則的名稱。

--start

指定 SAS 生效的 UTC 日期時間(Y-m-d'T'H:M'Z')。 如果以指定此值的 --policy-name 參考預存存取原則,請勿使用 。 預設為要求的時間。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage file generate-sas (storage-preview 擴充功能)

預覽

命令群組 'az storage' 處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

產生檔案的共用存取簽章。

az storage file generate-sas --path
                             --share-name
                             [--account-key]
                             [--account-name]
                             [--cache-control]
                             [--connection-string]
                             [--content-disposition]
                             [--content-encoding]
                             [--content-language]
                             [--content-type]
                             [--disallow-trailing-dot {false, true}]
                             [--expiry]
                             [--https-only]
                             [--ip]
                             [--permissions]
                             [--policy-name]
                             [--start]

範例

產生檔案的 SAS 權杖。

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage file generate-sas -p path/file.txt -s MyShare --account-name MyStorageAccount --permissions rcdw --https-only --expiry $end

產生檔案的共用存取簽章。 (自動產生)

az storage file generate-sas --account-name MyStorageAccount --expiry 2037-12-31T23:59:00Z --path path/file.txt --permissions rcdw --share-name MyShare --start 2019-01-01T12:20Z

產生檔案的共用存取簽章。 (自動產生)

az storage file generate-sas --account-key 00000000 --account-name mystorageaccount --expiry 2037-12-31T23:59:00Z --https-only --path path/file.txt --permissions rcdw --share-name myshare

必要參數

--path -p

檔案共用內檔案的路徑。

--share-name -s

檔案共用名稱稱。

選擇性參數

--account-key

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

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與儲存體帳戶金鑰或 SAS 權杖搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢儲存體帳戶金鑰。 如果執行大量儲存體命令,可能會叫用 API 配額。

--cache-control

當使用此共用存取簽章存取資源時,Cache-Control 的回應標頭值。

--connection-string

儲存體帳戶連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--content-disposition

當使用此共用存取簽章存取資源時,Content-Disposition 的回應標頭值。

--content-encoding

使用此共用存取簽章存取資源時,Content-Encoding 的回應標頭值。

--content-language

使用此共用存取簽章存取資源時,Content-Language 的回應標頭值。

--content-type

當使用此共用存取簽章存取資源時,Content-Type 的回應標頭值。

--disallow-trailing-dot

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

接受的值: false, true
預設值: False
--expiry

指定 SAS 不正確 UTC 日期時間(Y-m-d'T'H:M'Z')。 如果以指定此值的 --policy-name 參考預存存取原則,請勿使用 。

--https-only

只允許使用 HTTPS 通訊協定提出的要求。 如果省略,則允許來自 HTTP 和 HTTPS 通訊協定的要求。

--ip

指定要接受要求的 IP 位址或 IP 位址範圍。 僅支援 IPv4 樣式位址。

--permissions

SAS 授與的許可權。 允許的值: (c)reate (d)elete (r)ead (w)rite. 如果以指定此值的 --id 參考預存存取原則,請勿使用 。 可以合併。

--policy-name

容器 ACL 內預存存取原則的名稱。

--start

指定 SAS 生效的 UTC 日期時間(Y-m-d'T'H:M'Z')。 如果以指定此值的 --policy-name 參考預存存取原則,請勿使用 。 預設為要求的時間。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage file list

列出共用中的檔案和目錄。

az storage file list --share-name
                     [--account-key]
                     [--account-name]
                     [--auth-mode {key, login}]
                     [--backup-intent]
                     [--connection-string]
                     [--disallow-trailing-dot {false, true}]
                     [--exclude-dir]
                     [--exclude-extended-info]
                     [--file-endpoint]
                     [--marker]
                     [--num-results]
                     [--path]
                     [--sas-token]
                     [--snapshot]
                     [--timeout]

範例

列出共用中的檔案和目錄。 (自動產生)

az storage file list --share-name MyShare

必要參數

--share-name -s

檔案共用名稱稱。

選擇性參數

--account-key

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

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與儲存體帳戶金鑰或 SAS 權杖搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢儲存體帳戶金鑰。 如果執行大量儲存體命令,可能會叫用 API 配額。

--auth-mode

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

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

與檔案的 OAuth (Azure AD) 驗證搭配使用的必要參數。 這會略過任何檔案/目錄層級許可權檢查,並根據允許的資料動作允許存取,即使這些檔案/目錄有 ACL。

預設值: False
--connection-string

儲存體帳戶連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

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

接受的值: false, true
預設值: False
--exclude-dir

僅列出指定共用中的檔案。

預設值: False
--exclude-extended-info

指定 以從回應中排除 「timestamps」、「Etag」、「Attributes」、「PermissionKey」 資訊。

預設值: False
--file-endpoint

儲存體資料服務端點。 必須與儲存體帳戶金鑰或 SAS 權杖搭配使用。 您可以使用 找到每個服務主要端點 az storage account show 。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。

--marker

字串值,識別要隨著下一個清單作業傳回之容器清單的部分。 如果清單作業未傳回剩餘的所有容器,則此作業會傳迴響應主體內的 NextMarker 值,以與目前頁面一起列出。 如果指定,這個產生器會從前一個產生器停止的點開始傳回結果。

--num-results

指定要傳回的最大數目。 如果要求未指定num_results,或指定大於 5000 的值,伺服器將傳回最多 5000 個專案。 請注意,如果清單作業跨越資料分割界限,則服務會傳回接續權杖,以擷取其餘的結果。 提供 「*」 以傳回全部。

預設值: 5000
--path -p

檔案共用內的目錄路徑。

--sas-token

共用存取簽章 (SAS)。 必須與儲存體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

--snapshot

表示快照集版本的字串,如果適用的話。

--timeout

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

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage file list (storage-preview 擴充功能)

預覽

命令群組 『az storage』 處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

列出共用中的檔案和目錄。

az storage file list --share-name
                     [--account-key]
                     [--account-name]
                     [--auth-mode {key, login}]
                     [--backup-intent]
                     [--connection-string]
                     [--disallow-trailing-dot {false, true}]
                     [--exclude-dir]
                     [--exclude-extended-info]
                     [--marker]
                     [--num-results]
                     [--path]
                     [--sas-token]
                     [--snapshot]
                     [--timeout]

範例

列出共用中的檔案和目錄。 (自動產生)

az storage file list --share-name MyShare

必要參數

--share-name -s

檔案共享名稱。

選擇性參數

--account-key

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

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與儲存體帳戶金鑰或 SAS 權杖搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢儲存體帳戶金鑰。 如果執行大量儲存體命令,可能會叫用 API 配額。

--auth-mode

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

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

與檔案的 OAuth (Azure AD) 驗證搭配使用的必要參數。 這會略過任何檔案/目錄層級許可權檢查,並根據允許的數據動作允許存取,即使這些檔案/目錄有 ACL。

預設值: False
--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

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

接受的值: false, true
預設值: False
--exclude-dir

僅列出指定共用中的檔案。

預設值: False
--exclude-extended-info

指定 以從回應中排除 「timestamps」、“Etag”、“Attributes”、“PermissionKey” 資訊。

預設值: False
--marker

字串值,識別要隨著下一個清單作業傳回之容器清單的部分。 如果清單作業未傳回剩餘的所有容器,則此作業會傳回響應主體內的 NextMarker 值,以與目前頁面一起列出。 如果指定,這個產生器會從前一個產生器停止的點開始傳回結果。

--num-results

指定要傳回的結果數目上限。 提供 「*」 以傳回全部。

預設值: 5000
--path -p

檔案共用內的目錄路徑。

--sas-token

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

--snapshot

表示快照集版本的字串,如果適用的話。

--timeout

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

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage file resize

將檔案大小調整為指定的大小。

如果指定的位元組值小於檔案的目前大小,則會清除指定位元組值上方的所有範圍。

az storage file resize --path
                       --share-name
                       --size
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--backup-intent]
                       [--connection-string]
                       [--disallow-trailing-dot {false, true}]
                       [--file-endpoint]
                       [--sas-token]
                       [--timeout]

必要參數

--path -p

檔案共用內檔案的路徑。

--share-name -s

檔案共享名稱。

--size

大小,將檔案大小調整為 (以位元組為單位)。

選擇性參數

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

與檔案的 OAuth (Azure AD) 驗證搭配使用的必要參數。 這會略過任何檔案/目錄層級許可權檢查,並根據允許的數據動作允許存取,即使這些檔案/目錄有 ACL。

預設值: False
--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

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

接受的值: false, true
預設值: False
--file-endpoint

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

--sas-token

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

--timeout

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

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage file resize (storage-preview 擴充功能)

預覽

命令群組 『az storage』 處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

將檔案大小調整為指定的大小。

如果指定的位元組值小於檔案的目前大小,則會清除指定位元組值上方的所有範圍。

az storage file resize --path
                       --share-name
                       --size
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--backup-intent]
                       [--connection-string]
                       [--disallow-trailing-dot {false, true}]
                       [--sas-token]
                       [--timeout]

必要參數

--path -p

檔案共用內檔案的路徑。

--share-name -s

檔案共享名稱。

--size

大小,將檔案大小調整為 (以位元組為單位)。

選擇性參數

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

與檔案的 OAuth (Azure AD) 驗證搭配使用的必要參數。 這會略過任何檔案/目錄層級許可權檢查,並根據允許的數據動作允許存取,即使這些檔案/目錄有 ACL。

預設值: False
--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

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

接受的值: false, true
預設值: False
--sas-token

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

--timeout

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

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage file show

傳回檔案的所有使用者定義元數據、標準 HTTP 屬性和系統屬性。

az storage file show --path
                     --share-name
                     [--account-key]
                     [--account-name]
                     [--auth-mode {key, login}]
                     [--backup-intent]
                     [--connection-string]
                     [--disallow-trailing-dot {false, true}]
                     [--file-endpoint]
                     [--sas-token]
                     [--snapshot]
                     [--timeout]

範例

在檔案共享中顯示檔案的屬性。

az storage file show -p dir/a.txt -s sharename --account-name myadlsaccount --account-key 0000-0000

必要參數

--path -p

檔案共用內檔案的路徑。

--share-name -s

檔案共享名稱。

選擇性參數

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

與檔案的 OAuth (Azure AD) 驗證搭配使用的必要參數。 這會略過任何檔案/目錄層級許可權檢查,並根據允許的數據動作允許存取,即使這些檔案/目錄有 ACL。

預設值: False
--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

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

接受的值: false, true
預設值: False
--file-endpoint

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

--sas-token

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

--snapshot

表示快照集版本的字串,如果適用的話。

--timeout

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

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage file show (storage-preview 擴充功能)

預覽

命令群組 『az storage』 處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

傳回檔案的所有使用者定義元數據、標準 HTTP 屬性和系統屬性。

az storage file show --path
                     --share-name
                     [--account-key]
                     [--account-name]
                     [--auth-mode {key, login}]
                     [--backup-intent]
                     [--connection-string]
                     [--disallow-trailing-dot {false, true}]
                     [--sas-token]
                     [--snapshot]
                     [--timeout]

範例

在檔案共享中顯示檔案的屬性。

az storage file show -p dir/a.txt -s sharename --account-name myadlsaccount --account-key 0000-0000

必要參數

--path -p

檔案共用內檔案的路徑。

--share-name -s

檔案共享名稱。

選擇性參數

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

與檔案的 OAuth (Azure AD) 驗證搭配使用的必要參數。 這會略過任何檔案/目錄層級許可權檢查,並根據允許的數據動作允許存取,即使這些檔案/目錄有 ACL。

預設值: False
--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

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

接受的值: false, true
預設值: False
--sas-token

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

--snapshot

表示快照集版本的字串,如果適用的話。

--timeout

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

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage file update

在檔案上設定系統屬性。

如果為content_settings設定一個屬性,則會覆寫所有屬性。

az storage file update --path
                       --share-name
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--backup-intent]
                       [--clear-content-settings {false, true}]
                       [--connection-string]
                       [--content-cache]
                       [--content-disposition]
                       [--content-encoding]
                       [--content-language]
                       [--content-md5]
                       [--content-type]
                       [--disallow-trailing-dot {false, true}]
                       [--file-endpoint]
                       [--sas-token]
                       [--timeout]

範例

在檔案上設定系統屬性。

az storage file update -p dir/a.txt -s sharename --account-name myadlsaccount --account-key 0000-0000 --content-type test/type

必要參數

--path -p

檔案共用內檔案的路徑。

--share-name -s

檔案共享名稱。

選擇性參數

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

與檔案的 OAuth (Azure AD) 驗證搭配使用的必要參數。 這會略過任何檔案/目錄層級許可權檢查,並根據允許的數據動作允許存取,即使這些檔案/目錄有 ACL。

預設值: False
--clear-content-settings

如果已設定此旗標,則如果已設定下列任何一或多個屬性(--content-cache-control、--content-disposition、--content-encoding、--content-language、--content-md5、--content-type),則所有這些屬性都會一起設定。 如果至少設定下列其中一個屬性時,未提供給定屬性的值,則會清除該屬性。

接受的值: false, true
--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--content-cache --content-cache-control

快取控制字串。

--content-disposition

傳達有關如何處理響應承載的其他資訊,也可用來附加其他元數據。

--content-encoding

內容編碼類型。

--content-language

內容語言。

--content-md5

內容的 MD5 哈希。

--content-type

內容MIME類型。

--disallow-trailing-dot

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

接受的值: false, true
預設值: False
--file-endpoint

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

--sas-token

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

--timeout

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

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage file update (storage-preview 擴充功能)

預覽

命令群組 'az storage' 處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

在檔案上設定系統屬性。

如果為content_settings設定一個屬性,則會覆寫所有屬性。

az storage file update --path
                       --share-name
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--backup-intent]
                       [--clear-content-settings {false, true}]
                       [--connection-string]
                       [--content-cache]
                       [--content-disposition]
                       [--content-encoding]
                       [--content-language]
                       [--content-md5]
                       [--content-type]
                       [--disallow-trailing-dot {false, true}]
                       [--sas-token]
                       [--timeout]

範例

在檔案上設定系統屬性。

az storage file update -p dir/a.txt -s sharename --account-name myadlsaccount --account-key 0000-0000 --content-type test/type

必要參數

--path -p

檔案共用內檔案的路徑。

--share-name -s

檔案共用名稱稱。

選擇性參數

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

與檔案的 OAuth (Azure AD) 驗證搭配使用的必要參數。 這會略過任何檔案/目錄層級許可權檢查,並根據允許的數據動作允許存取,即使這些檔案/目錄有 ACL。

預設值: False
--clear-content-settings

如果已設定此旗標,則如果已設定下列任何一或多個屬性(--content-cache-control、--content-disposition、--content-encoding、--content-language、--content-md5、--content-type),則所有這些屬性都會一起設定。 如果至少設定下列其中一個屬性時,未提供給定屬性的值,則會清除該屬性。

接受的值: false, true
--connection-string

儲存體帳戶連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--content-cache --content-cache-control

快取控制字元串。

--content-disposition

傳達有關如何處理回應承載的其他資訊,也可用來附加其他中繼資料。

--content-encoding

內容編碼類型。

--content-language

內容語言。

--content-md5

內容的 MD5 雜湊。

--content-type

內容 MIME 類型。

--disallow-trailing-dot

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

接受的值: false, true
預設值: False
--sas-token

共用存取簽章 (SAS)。 必須與儲存體帳戶名稱搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

--timeout

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

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage file upload

將檔案上傳至使用 SMB 3.0 通訊協定的共用。

使用自動區塊化和進度通知,從來源路徑建立或更新 Azure 檔案。

az storage file upload --source
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--backup-intent]
                       [--connection-string]
                       [--content-cache]
                       [--content-disposition]
                       [--content-encoding]
                       [--content-language]
                       [--content-md5]
                       [--content-type]
                       [--disallow-trailing-dot {false, true}]
                       [--file-endpoint]
                       [--file-url]
                       [--max-connections]
                       [--metadata]
                       [--no-progress]
                       [--path]
                       [--sas-token]
                       [--share-name]
                       [--timeout]
                       [--validate-content]

範例

上傳至本機檔案至共用。

az storage file upload -s MyShare --source /path/to/file

將檔案上傳至使用 SMB 3.0 通訊協定的共用。 (自動產生)

az storage file upload --account-key 00000000 --account-name MyStorageAccount --path path/file.txt --share-name MyShare --source /path/to/file

必要參數

--source

要上傳為檔案內容之本機檔案的路徑。

選擇性參數

--account-key

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

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與儲存體帳戶金鑰或 SAS 權杖搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢儲存體帳戶金鑰。 如果執行大量儲存體命令,可能會叫用 API 配額。

--auth-mode

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

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

與檔案的 OAuth (Azure AD) 驗證搭配使用的必要參數。 這會略過任何檔案/目錄層級許可權檢查,並根據允許的資料動作允許存取,即使這些檔案/目錄有 ACL。

預設值: False
--connection-string

儲存體帳戶連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--content-cache --content-cache-control

快取控制字元串。

--content-disposition

傳達有關如何處理回應承載的其他資訊,也可用來附加其他中繼資料。

--content-encoding

內容編碼類型。

--content-language

內容語言。

--content-md5

內容的 MD5 雜湊。

--content-type

內容 MIME 類型。

--disallow-trailing-dot

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

接受的值: false, true
預設值: False
--file-endpoint

儲存體資料服務端點。 必須與儲存體帳戶金鑰或 SAS 權杖搭配使用。 您可以使用 找到每個服務主要端點 az storage account show 。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。

--file-url

檔案的完整端點 URL,如果已使用,包括 SAS 權杖。

--max-connections

要使用的平行連線數目上限。

預設值: 2
--metadata

空格分隔索引鍵=值組中的中繼資料。 這會覆寫任何現有的中繼資料。

--no-progress

包含此旗標以停用命令的進度報告。

預設值: False
--path -p

檔案共用內檔案的路徑。 如果省略檔案名,則會使用來原始檔案名。

--sas-token

共用存取簽章 (SAS)。 必須與儲存體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

--share-name -s

檔案共用名稱稱。

--timeout

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

--validate-content

如果為 true,則計算檔案每個範圍的 MD5 雜湊。 儲存體服務會檢查已隨已傳送之雜湊而抵達的內容雜湊。 如果使用 HTTP 而非 HTTPs 作為 HTTPs,這主要對於偵測網路上的 bitflip 相當有價值(預設值)已經驗證。 請注意,此 MD5 雜湊不會與檔案一起儲存。

預設值: False
全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage file upload (storage-preview 擴充功能)

預覽

命令群組 『az storage』 處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

將檔案上傳至使用SMB 3.0通訊協議的共用。

使用自動區塊化和進度通知,從來源路徑建立或更新 Azure 檔案。

az storage file upload --share-name
                       --source
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--backup-intent]
                       [--connection-string]
                       [--content-cache]
                       [--content-disposition]
                       [--content-encoding]
                       [--content-language]
                       [--content-md5]
                       [--content-type]
                       [--disallow-trailing-dot {false, true}]
                       [--max-connections]
                       [--metadata]
                       [--no-progress]
                       [--path]
                       [--sas-token]
                       [--timeout]
                       [--validate-content]

範例

上傳至本機檔案至共用。

az storage file upload -s MyShare --source /path/to/file

將檔案上傳至使用 SMB 3.0 通訊協定的共用。 (自動產生)

az storage file upload --account-key 00000000 --account-name MyStorageAccount --path path/file.txt --share-name MyShare --source /path/to/file

必要參數

--share-name -s

檔案共享名稱。

--source

要上傳為檔案內容之本機檔案的路徑。

選擇性參數

--account-key

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

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與儲存體帳戶金鑰或 SAS 權杖搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢儲存體帳戶金鑰。 如果執行大量儲存體命令,可能會叫用 API 配額。

--auth-mode

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

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

與檔案的 OAuth (Azure AD) 驗證搭配使用的必要參數。 這會略過任何檔案/目錄層級許可權檢查,並根據允許的資料動作允許存取,即使這些檔案/目錄有 ACL。

預設值: False
--connection-string

儲存體帳戶連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--content-cache --content-cache-control

快取控制字元串。

--content-disposition

傳達有關如何處理回應承載的其他資訊,也可用來附加其他中繼資料。

--content-encoding

內容編碼類型。

--content-language

內容語言。

--content-md5

內容的 MD5 雜湊。

--content-type

內容 MIME 類型。

--disallow-trailing-dot

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

接受的值: false, true
預設值: False
--max-connections

要使用的平行連線數目上限。

預設值: 2
--metadata

空格分隔索引鍵=值組中的中繼資料。 這會覆寫任何現有的元數據。

--no-progress

包含此旗標以停用命令的進度報告。

預設值: False
--path -p

檔案共用內檔案的路徑。 如果省略檔名,則會使用來源檔名。

--sas-token

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

--timeout

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

--validate-content

如果為 true,則計算檔案每個範圍的 MD5 哈希。 記憶體服務會檢查已隨已傳送之哈希而抵達的內容哈希。 如果使用 HTTP 而非 HTTPs 作為 HTTPs,這主要對於偵測網路上的 bitflip 相當有價值(預設值)已經驗證。 請注意,此 MD5 哈希不會與檔案一起儲存。

預設值: False
全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage file upload-batch

將檔案從本機目錄上傳至批次作業中的 Azure 儲存體 檔案共用。

az storage file upload-batch --destination
                             --source
                             [--account-key]
                             [--account-name]
                             [--connection-string]
                             [--content-cache]
                             [--content-disposition]
                             [--content-encoding]
                             [--content-language]
                             [--content-md5]
                             [--content-type]
                             [--destination-path]
                             [--disallow-trailing-dot {false, true}]
                             [--dryrun]
                             [--file-endpoint]
                             [--max-connections]
                             [--metadata]
                             [--no-progress]
                             [--pattern]
                             [--sas-token]
                             [--validate-content]

範例

將檔案從本機目錄上傳至批次作業中的 Azure 儲存體 檔案共用。

az storage file upload-batch --destination myshare --source . --account-name myaccount --account-key 00000000

使用批次作業中的 url,將檔案從本機目錄上傳至 Azure 儲存體 檔案共用。

az storage file upload-batch --destination https://myaccount.file.core.windows.net/myshare --source . --account-key 00000000

必要參數

--destination -d

上傳作業的目的地。

目的地可以是檔案共享URL或共享名稱。 當目的地是共用URL時,會從URL剖析記憶體帳戶名稱。

--source -s

要上傳檔案的目錄。

選擇性參數

--account-key

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

--account-name

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

--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--content-cache --content-cache-control

快取控制字串。

--content-disposition

傳達有關如何處理響應承載的其他資訊,也可用來附加其他元數據。

--content-encoding

內容編碼類型。

--content-language

內容語言。

--content-md5

內容的 MD5 哈希。

--content-type

內容MIME類型。

--destination-path

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

--disallow-trailing-dot

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

接受的值: false, true
預設值: False
--dryrun

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

預設值: False
--file-endpoint

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

--max-connections

要使用的平行連線數目上限。 預設值為 1。

預設值: 1
--metadata

空格分隔索引鍵=值組中的元數據。 這會覆寫任何現有的元數據。

--no-progress

包含此旗標以停用命令的進度報告。

預設值: False
--pattern

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

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

--sas-token

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

--validate-content

如果已設定,則計算檔案每個範圍的 MD5 哈希以進行驗證。

記憶體服務會檢查已抵達之內容的哈希,與已傳送的哈希相同。 如果使用 HTTP 而不是 HTTPS,在傳輸期間偵測 bitflip,這最有價值。 此哈希不會儲存。

預設值: False
全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

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

預覽

命令群組 『az storage』 處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

將檔案從本機目錄上傳至批次作業中的 Azure 儲存體 檔案共用。

az storage file upload-batch --destination
                             --source
                             [--account-key]
                             [--account-name]
                             [--connection-string]
                             [--content-cache]
                             [--content-disposition]
                             [--content-encoding]
                             [--content-language]
                             [--content-md5]
                             [--content-type]
                             [--destination-path]
                             [--disallow-trailing-dot {false, true}]
                             [--dryrun]
                             [--max-connections]
                             [--metadata]
                             [--no-progress]
                             [--pattern]
                             [--sas-token]
                             [--validate-content]

範例

將檔案從本機目錄上傳至批次作業中的 Azure 儲存體 檔案共用。

az storage file upload-batch --destination myshare --source . --account-name myaccount --account-key 00000000

使用批次作業中的 url,將檔案從本機目錄上傳至 Azure 儲存體 檔案共用。

az storage file upload-batch --destination https://myaccount.file.core.windows.net/myshare --source . --account-key 00000000

必要參數

--destination -d

上傳作業的目的地。

目的地可以是檔案共享URL或共享名稱。 當目的地是共用URL時,會從URL剖析記憶體帳戶名稱。

--source -s

要上傳檔案的目錄。

選擇性參數

--account-key

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

--account-name

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

--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--content-cache --content-cache-control

快取控制字串。

--content-disposition

傳達有關如何處理響應承載的其他資訊,也可用來附加其他元數據。

--content-encoding

內容編碼類型。

--content-language

內容語言。

--content-md5

內容的 MD5 哈希。

--content-type

內容MIME類型。

--destination-path

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

--disallow-trailing-dot

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

接受的值: false, true
預設值: False
--dryrun

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

預設值: False
--max-connections

要使用的平行連線數目上限。 預設值為 1。

預設值: 1
--metadata

空格分隔索引鍵=值組中的元數據。 這會覆寫任何現有的元數據。

--no-progress

包含此旗標以停用命令的進度報告。

預設值: False
--pattern

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

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

--sas-token

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

--validate-content

如果已設定,則計算檔案每個範圍的 MD5 哈希以進行驗證。

記憶體服務會檢查已抵達之內容的哈希,與已傳送的哈希相同。 如果使用 HTTP 而不是 HTTPS,在傳輸期間偵測 bitflip,這最有價值。 此哈希不會儲存。

預設值: False
全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage file url

建立 URL 以存取檔案。

az storage file url --path
                    --share-name
                    [--account-key]
                    [--account-name]
                    [--auth-mode {key, login}]
                    [--backup-intent]
                    [--connection-string]
                    [--disallow-trailing-dot {false, true}]
                    [--file-endpoint]
                    [--protocol {http, https}]
                    [--sas-token]

範例

建立 URL 以存取檔案。 ( 自動產生 )

az storage file url --account-key 00000000 --account-name mystorageaccount --path path/file.txt --share-name myshare

必要參數

--path -p

檔案共享內檔案/目錄的路徑。

--share-name -s

檔案共享名稱。

選擇性參數

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

與檔案的 OAuth (Azure AD) 驗證搭配使用的必要參數。 這會略過任何檔案/目錄層級許可權檢查,並根據允許的數據動作允許存取,即使這些檔案/目錄有 ACL。

預設值: False
--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

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

接受的值: false, true
預設值: False
--file-endpoint

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

--protocol

要使用的通訊協定。

接受的值: http, https
預設值: https
--sas-token

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

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage file url (storage-preview 擴充功能)

預覽

命令群組 『az storage』 處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

建立 URL 以存取檔案。

az storage file url --path
                    --share-name
                    [--account-key]
                    [--account-name]
                    [--auth-mode {key, login}]
                    [--backup-intent]
                    [--connection-string]
                    [--disallow-trailing-dot {false, true}]
                    [--protocol {http, https}]
                    [--sas-token]

範例

建立 URL 以存取檔案。 ( 自動產生 )

az storage file url --account-key 00000000 --account-name mystorageaccount --path path/file.txt --share-name myshare

必要參數

--path -p

檔案共享內檔案/目錄的路徑。

--share-name -s

檔案共享名稱。

選擇性參數

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

與檔案的 OAuth (Azure AD) 驗證搭配使用的必要參數。 這會略過任何檔案/目錄層級許可權檢查,並根據允許的數據動作允許存取,即使這些檔案/目錄有 ACL。

預設值: False
--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

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

接受的值: false, true
預設值: False
--protocol

要使用的通訊協定。

接受的值: http, https
預設值: https
--sas-token

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

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

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

--subscription

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

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。