共用方式為

az storage file

Note

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

管理檔案共用。

命令

名稱 Description 類型 狀態
az storage file copy

管理檔案複製作業。

 核心和擴充功能 GA
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 delete

標示要刪除的指定檔案。

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

標示要刪除的指定檔案。

 Extension GA
az storage file delete-batch

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

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

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

 Extension GA
az storage file download

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

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

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

 Extension GA
az storage file download-batch

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

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

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

 Extension GA
az storage file exists

檢查檔案是否存在。

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

檢查檔案是否存在。

 Extension GA
az storage file generate-sas

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

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

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

 Extension GA
az storage file hard-link

管理記憶體檔案硬式連結。

 Core GA
az storage file hard-link create

僅限 NFS。 建立路徑所指定檔案的硬連結。

 Core GA
az storage file list

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

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

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

 Extension GA
az storage file metadata

管理檔案元數據。

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

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

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

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

 Extension GA
az storage file metadata update

更新檔案元數據。

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

更新檔案元數據。

 Extension GA
az storage file resize

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

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

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

 Extension GA
az storage file show

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

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

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

 Extension GA
az storage file symbolic-link

管理儲存檔案 symbolic-link。

 Core GA
az storage file symbolic-link create

僅限 NFS。 建立指定檔案的符號連結。

 Core GA
az storage file symbolic-link show

僅限 NFS。 取得檔案用戶端的符號連結。

 Core GA
az storage file update

在檔案上設定系統屬性。

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

在檔案上設定系統屬性。

 Extension GA
az storage file upload

將檔案上傳至共用。

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

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

 Extension GA
az storage file upload-batch

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

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

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

 Extension GA
az storage file url

建立 URL 以存取檔案。

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

建立 URL 以存取檔案。

 Extension GA

az storage file delete

編輯

標示要刪除的指定檔案。

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

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

必要參數

--path -p

檔案共用內檔案的路徑。

--share-name -s

檔案共享名稱。

選擇性參數

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

--account-key

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

屬性 值
參數群組: Storage Account Arguments
--account-name

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

屬性 值
參數群組: Storage Account Arguments
--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。

屬性 值
參數群組: 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 delete (storage-preview 擴充功能)

標示要刪除的指定檔案。

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

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

必要參數

--path -p

檔案共用內檔案的路徑。

--share-name -s

檔案共享名稱。

選擇性參數

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

--account-key

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

屬性 值
參數群組: Storage Account Arguments
--account-name

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

屬性 值
參數群組: Storage Account Arguments
--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。

屬性 值
參數群組: 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 delete-batch

編輯

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

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

範例

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

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

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

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。

屬性 值
參數群組: Storage Account Arguments
--account-name

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

屬性 值
參數群組: Storage Account Arguments
--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。

屬性 值
參數群組: Storage Account Arguments
--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
--pattern

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

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

--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 delete-batch (storage-preview 擴充功能)

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

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

範例

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

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

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

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。

屬性 值
參數群組: Storage Account Arguments
--account-name

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

屬性 值
參數群組: Storage Account Arguments
--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。

屬性 值
參數群組: Storage Account Arguments
--disallow-trailing-dot

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

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

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

屬性 值
預設值: False
--pattern

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

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

--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 download

編輯

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

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

az storage file download --path
                         --share-name
                         [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--backup-intent --enable-file-backup-request-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。

屬性 值
參數群組: Storage Account Arguments
--account-name

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

屬性 值
參數群組: Storage Account Arguments
--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。

屬性 值
參數群組: Storage Account Arguments
--dest

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

--disallow-trailing-dot

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

屬性 值
預設值: False
接受的值: false, true
--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。

屬性 值
參數群組: Storage Account Arguments
--max-connections

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

屬性 值
預設值: 2
--no-progress

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

屬性 值
預設值: False
--open-mode

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

屬性 值
預設值: wb
--sas-token

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

屬性 值
參數群組: Storage Account Arguments
--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

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

屬性 值
預設值: 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 download (storage-preview 擴充功能)

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

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

az storage file download --path
                         --share-name
                         [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--backup-intent --enable-file-backup-request-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。

屬性 值
參數群組: Storage Account Arguments
--account-name

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

屬性 值
參數群組: Storage Account Arguments
--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。

屬性 值
參數群組: Storage Account Arguments
--dest

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

--disallow-trailing-dot

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

屬性 值
預設值: False
接受的值: false, true
--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。

屬性 值
參數群組: Storage Account Arguments
--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

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

屬性 值
預設值: 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 download-batch

編輯

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

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

範例

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

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。

屬性 值
參數群組: Storage Account Arguments
--account-name

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

屬性 值
參數群組: Storage Account Arguments
--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。

屬性 值
參數群組: Storage Account Arguments
--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
--max-connections

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

屬性 值
參數群組: Download Control Arguments
預設值: 1
--no-progress

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

屬性 值
預設值: False
--pattern

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

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

--sas-token

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

屬性 值
參數群組: Storage Account Arguments
--snapshot

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

--validate-content

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

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

屬性 值
預設值: False
全域參數
--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 download-batch (storage-preview 擴充功能)

將檔案從 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 儲存體 檔案共享下載到批次作業中的本機目錄。 (autogenerated)

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。

屬性 值
參數群組: Storage Account Arguments
--account-name

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

屬性 值
參數群組: Storage Account Arguments
--connection-string

記憶體帳戶連接字串。 環境變數：AZURE_STORAGE_CONNECTION_STRING。

屬性 值
參數群組: Storage Account Arguments
--disallow-trailing-dot

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

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

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

屬性 值
預設值: False
--max-connections

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

屬性 值
參數群組: Download Control Arguments
預設值: 1
--no-progress

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

屬性 值
預設值: False
--pattern

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

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

--sas-token

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

屬性 值
參數群組: Storage Account Arguments
--snapshot

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

--validate-content

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

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

屬性 值
預設值: False
全域參數
--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 exists

編輯

檢查檔案是否存在。

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

範例

檢查檔案是否存在。 (autogenerated)

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

檢查檔案是否存在。 (autogenerated)

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

必要參數

--path -p

檔案共用內檔案的路徑。

--share-name -s

檔案共享名稱。

選擇性參數

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

--account-key

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

屬性 值
參數群組: Storage Account Arguments
--account-name

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

屬性 值
參數群組: Storage Account Arguments
--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。

屬性 值
參數群組: 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
--snapshot

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

--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 exists (storage-preview 擴充功能)

檢查檔案是否存在。

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

範例

檢查檔案是否存在。 (autogenerated)

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

檢查檔案是否存在。 (autogenerated)

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

必要參數

--path -p

檔案共用內檔案的路徑。

--share-name -s

檔案共享名稱。

選擇性參數

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

--account-key

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

屬性 值
參數群組: Storage Account Arguments
--account-name

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

屬性 值
參數群組: Storage Account Arguments
--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。

屬性 值
參數群組: Storage Account Arguments
--disallow-trailing-dot

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

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

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

屬性 值
參數群組: Storage Account Arguments
--snapshot

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

--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 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

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

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

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

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。

屬性 值
參數群組: Storage Account Arguments
--account-name

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

屬性 值
參數群組: Storage Account Arguments
--cache-control

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

--connection-string

記憶體帳戶連接字串。 環境變數：AZURE_STORAGE_CONNECTION_STRING。

屬性 值
參數群組: Storage Account Arguments
--content-disposition

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

--content-encoding

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

--content-language

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

--content-type

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

--disallow-trailing-dot

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

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

指定 SAS 無效的 UTC 日期時間（Y-m-d'T'H：M'Z'）。 如果以指定此值的 --policy-name 參考預存取原則，請勿使用 。

--file-endpoint

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

屬性 值
參數群組: Storage Account Arguments
--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

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

屬性 值
預設值: 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 generate-sas (storage-preview 擴充功能)

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

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

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

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

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

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。

屬性 值
參數群組: Storage Account Arguments
--account-name

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

屬性 值
參數群組: Storage Account Arguments
--cache-control

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

--connection-string

記憶體帳戶連接字串。 環境變數：AZURE_STORAGE_CONNECTION_STRING。

屬性 值
參數群組: Storage Account Arguments
--content-disposition

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

--content-encoding

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

--content-language

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

--content-type

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

--disallow-trailing-dot

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

屬性 值
預設值: False
接受的值: false, true
--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

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

屬性 值
預設值: 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 list

編輯

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

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

範例

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

az storage file list --share-name MyShare

必要參數

--share-name -s

檔案共享名稱。

選擇性參數

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

--account-key

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

屬性 值
參數群組: Storage Account Arguments
--account-name

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

屬性 值
參數群組: Storage Account Arguments
--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。

屬性 值
參數群組: Storage Account Arguments
--disallow-trailing-dot

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

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

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

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

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

屬性 值
預設值: False
--file-endpoint

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

屬性 值
參數群組: Storage Account Arguments
--marker

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

--num-results

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

屬性 值
預設值: 5000
--path -p

檔案共用內的目錄路徑。

--sas-token

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

屬性 值
參數群組: Storage Account Arguments
--snapshot

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

--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 list (storage-preview 擴充功能)

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

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

範例

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

az storage file list --share-name MyShare

必要參數

--share-name -s

檔案共享名稱。

選擇性參數

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

--account-key

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

屬性 值
參數群組: Storage Account Arguments
--account-name

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

屬性 值
參數群組: Storage Account Arguments
--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。

屬性 值
參數群組: Storage Account Arguments
--disallow-trailing-dot

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

屬性 值
預設值: False
接受的值: false, true
--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。

屬性 值
參數群組: Storage Account Arguments
--snapshot

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

--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 resize

編輯

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

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

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

必要參數

--path -p

檔案共用內檔案的路徑。

--share-name -s

檔案共享名稱。

--size

大小，將檔案大小調整為 （以位元組為單位）。

選擇性參數

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

--account-key

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

屬性 值
參數群組: Storage Account Arguments
--account-name

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

屬性 值
參數群組: Storage Account Arguments
--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。

屬性 值
參數群組: 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 resize (storage-preview 擴充功能)

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

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

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

必要參數

--path -p

檔案共用內檔案的路徑。

--share-name -s

檔案共享名稱。

--size

大小，將檔案大小調整為 （以位元組為單位）。

選擇性參數

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

--account-key

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

屬性 值
參數群組: Storage Account Arguments
--account-name

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

屬性 值
參數群組: Storage Account Arguments
--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。

屬性 值
參數群組: 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 show

編輯

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

az storage file show --path
                     --share-name
                     [--account-key]
                     [--account-name]
                     [--auth-mode {key, login}]
                     [--backup-intent --enable-file-backup-request-intent]
                     [--connection-string]
                     [--disallow-trailing-dot {false, true}]
                     [--file-endpoint]
                     [--sas-token]
                     [--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。

屬性 值
參數群組: Storage Account Arguments
--account-name

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

屬性 值
參數群組: Storage Account Arguments
--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。

屬性 值
參數群組: 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
--snapshot

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

--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 show (storage-preview 擴充功能)

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

az storage file show --path
                     --share-name
                     [--account-key]
                     [--account-name]
                     [--auth-mode {key, login}]
                     [--backup-intent --enable-file-backup-request-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。

屬性 值
參數群組: Storage Account Arguments
--account-name

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

屬性 值
參數群組: Storage Account Arguments
--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。

屬性 值
參數群組: Storage Account Arguments
--disallow-trailing-dot

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

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

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

屬性 值
參數群組: Storage Account Arguments
--snapshot

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

--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 update

編輯

在檔案上設定系統屬性。

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

az storage file update --path
                       --share-name
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--backup-intent --enable-file-backup-request-intent]
                       [--clear-content-settings {false, true}]
                       [--connection-string]
                       [--content-cache --content-cache-control]
                       [--content-disposition]
                       [--content-encoding]
                       [--content-language]
                       [--content-md5]
                       [--content-type]
                       [--disallow-trailing-dot {false, true}]
                       [--file-endpoint]
                       [--file-mode]
                       [--group]
                       [--owner]
                       [--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。

屬性 值
參數群組: Storage Account Arguments
--account-name

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

屬性 值
參數群組: Storage Account Arguments
--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。

屬性 值
參數群組: Storage Account Arguments
--content-cache --content-cache-control

快取控制字串。

--content-disposition

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

--content-encoding

內容編碼類型。

--content-language

內容語言。

--content-md5

內容的 MD5 哈希。

--content-type

內容MIME類型。

--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 檔案。 要設定於檔案上的模式許可權。 支援符號 （rwxrw-rw-） 。 黏性位也受到支援，而且它是由字母 t 或 T 在最後字元位置表示，視其他類別的執行位是分別設定或未設定而定，沒有 t 或 T 表示未設定黏性位。」。

--group

僅適用於 NFS 檔案。 要設定於檔案上的擁有者群組標識碼 （GID）。 預設值為 0 （根群組）。

--owner

僅適用於 NFS 檔案。 要設定於檔案上的擁有者使用者標識碼 （UID）。 預設值為 0 （root）。

--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 update (storage-preview 擴充功能)

在檔案上設定系統屬性。

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

az storage file update --path
                       --share-name
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--backup-intent --enable-file-backup-request-intent]
                       [--clear-content-settings {false, true}]
                       [--connection-string]
                       [--content-cache --content-cache-control]
                       [--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。

屬性 值
參數群組: Storage Account Arguments
--account-name

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

屬性 值
參數群組: Storage Account Arguments
--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。

屬性 值
參數群組: Storage Account Arguments
--content-cache --content-cache-control

快取控制字串。

--content-disposition

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

--content-encoding

內容編碼類型。

--content-language

內容語言。

--content-md5

內容的 MD5 哈希。

--content-type

內容MIME類型。

--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 upload

編輯

將檔案上傳至共用。

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

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

範例

上傳至本機檔案至共用。

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

將檔案上傳至共用。

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。

屬性 值
參數群組: Storage Account Arguments
--account-name

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

屬性 值
參數群組: Storage Account Arguments
--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。

屬性 值
參數群組: Storage Account Arguments
--content-cache --content-cache-control

快取控制字串。

--content-disposition

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

--content-encoding

內容編碼類型。

--content-language

內容語言。

--content-md5

內容的 MD5 哈希。

--content-type

內容MIME類型。

--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 檔案。 要設定於檔案上的模式許可權。 支援符號 （rwxrw-rw-） 。 黏性位也受到支援，而且它是由字母 t 或 T 在最後字元位置表示，視其他類別的執行位是分別設定或未設定而定，沒有 t 或 T 表示未設定黏性位。」。

--file-url

檔案的完整端點 URL，如果已使用，包括 SAS 令牌。

--group

僅適用於 NFS 檔案。 要設定於檔案上的擁有者群組標識碼 （GID）。 預設值為 0 （根群組）。

--max-connections

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

屬性 值
預設值: 2
--metadata

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

--no-progress

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

屬性 值
預設值: False
--owner

僅適用於 NFS 檔案。 要設定於檔案上的擁有者使用者標識碼 （UID）。 預設值為 0 （root）。

--path -p

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

--sas-token

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

屬性 值
參數群組: Storage Account Arguments
--share-name -s

檔案共享名稱。

--timeout

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

--validate-content

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

屬性 值
預設值: False
全域參數
--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 upload (storage-preview 擴充功能)

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

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

az storage file upload --share-name
                       --source
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--backup-intent --enable-file-backup-request-intent]
                       [--connection-string]
                       [--content-cache --content-cache-control]
                       [--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通訊協議的共用。 (autogenerated)

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。

屬性 值
參數群組: Storage Account Arguments
--account-name

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

屬性 值
參數群組: Storage Account Arguments
--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。

屬性 值
參數群組: Storage Account Arguments
--content-cache --content-cache-control

快取控制字串。

--content-disposition

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

--content-encoding

內容編碼類型。

--content-language

內容語言。

--content-md5

內容的 MD5 哈希。

--content-type

內容MIME類型。

--disallow-trailing-dot

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

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

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

屬性 值
預設值: 2
--metadata

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

--no-progress

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

屬性 值
預設值: False
--path -p

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

--sas-token

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

屬性 值
參數群組: Storage Account Arguments
--timeout

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

--validate-content

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

屬性 值
預設值: False
全域參數
--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 upload-batch

編輯

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

az storage file upload-batch --destination
                             --source
                             [--account-key]
                             [--account-name]
                             [--auth-mode {key, login}]
                             [--backup-intent --enable-file-backup-request-intent]
                             [--connection-string]
                             [--content-cache --content-cache-control]
                             [--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。

屬性 值
參數群組: Storage Account Arguments
--account-name

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

屬性 值
參數群組: Storage Account Arguments
--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。

屬性 值
參數群組: Storage Account Arguments
--content-cache --content-cache-control

快取控制字串。

屬性 值
參數群組: Content Settings Arguments
--content-disposition

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

屬性 值
參數群組: Content Settings Arguments
--content-encoding

內容編碼類型。

屬性 值
參數群組: Content Settings Arguments
--content-language

內容語言。

屬性 值
參數群組: Content Settings Arguments
--content-md5

內容的 MD5 哈希。

屬性 值
參數群組: Content Settings Arguments
--content-type

內容MIME類型。

屬性 值
參數群組: Content Settings Arguments
--destination-path

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

--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
--max-connections

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

屬性 值
參數群組: Download Control Arguments
預設值: 1
--metadata

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

--no-progress

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

屬性 值
預設值: False
--pattern

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

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

--sas-token

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

屬性 值
參數群組: Storage Account Arguments
--validate-content

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

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

屬性 值
預設值: False
全域參數
--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 upload-batch (storage-preview 擴充功能)

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

az storage file upload-batch --destination
                             --source
                             [--account-key]
                             [--account-name]
                             [--connection-string]
                             [--content-cache --content-cache-control]
                             [--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。

屬性 值
參數群組: Storage Account Arguments
--account-name

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

屬性 值
參數群組: Storage Account Arguments
--connection-string

記憶體帳戶連接字串。 環境變數：AZURE_STORAGE_CONNECTION_STRING。

屬性 值
參數群組: Storage Account Arguments
--content-cache --content-cache-control

快取控制字串。

屬性 值
參數群組: Content Settings Arguments
--content-disposition

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

屬性 值
參數群組: Content Settings Arguments
--content-encoding

內容編碼類型。

屬性 值
參數群組: Content Settings Arguments
--content-language

內容語言。

屬性 值
參數群組: Content Settings Arguments
--content-md5

內容的 MD5 哈希。

屬性 值
參數群組: Content Settings Arguments
--content-type

內容MIME類型。

屬性 值
參數群組: Content Settings Arguments
--destination-path

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

--disallow-trailing-dot

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

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

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

屬性 值
預設值: False
--max-connections

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

屬性 值
參數群組: Download Control Arguments
預設值: 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。

屬性 值
參數群組: Storage Account Arguments
--validate-content

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

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

屬性 值
預設值: False
全域參數
--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 url

編輯

建立 URL 以存取檔案。

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

範例

建立 URL 以存取檔案。 (autogenerated)

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。

屬性 值
參數群組: Storage Account Arguments
--account-name

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

屬性 值
參數群組: Storage Account Arguments
--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。

屬性 值
參數群組: 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
--protocol

要使用的通訊協定。

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

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

屬性 值
參數群組: Storage Account Arguments
全域參數
--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 url (storage-preview 擴充功能)

建立 URL 以存取檔案。

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

範例

建立 URL 以存取檔案。 (autogenerated)

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。

屬性 值
參數群組: Storage Account Arguments
--account-name

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

屬性 值
參數群組: Storage Account Arguments
--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。

屬性 值
參數群組: Storage Account Arguments
--disallow-trailing-dot

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

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

要使用的通訊協定。

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

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

屬性 值
參數群組: Storage Account Arguments
全域參數
--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