az storage share

注意

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

管理檔案共用。

命令

名稱 Description 類型 狀態
az storage share close-handle

關閉檔案共享的檔案句柄。

核心 GA
az storage share close-handle (storage-preview 擴充功能)

關閉檔案共享的檔案句柄。

副檔名 預覽版
az storage share create

在指定的帳戶下建立新的共用。

核心 GA
az storage share delete

標示要刪除的指定共用。

核心 GA
az storage share exists

檢查檔案共用是否存在。

核心 GA
az storage share generate-sas

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

核心 GA
az storage share list

列出記憶體帳戶中的檔案共用。

核心 GA
az storage share list-handle

列出檔案共享的檔案句柄。

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

列出檔案共享的檔案句柄。

副檔名 預覽版
az storage share metadata

管理檔案共用的元數據。

核心 GA
az storage share metadata show

傳回指定共用的所有使用者定義元數據。

核心 GA
az storage share metadata update

為指定的共享設定一或多個使用者定義的名稱/值組。

核心 GA
az storage share policy

管理記憶體檔案共享的共用存取原則。

核心 GA
az storage share policy create

在包含的物件上建立預存存取原則。

核心 GA
az storage share policy delete

刪除包含物件的預存存取原則。

核心 GA
az storage share policy list

列出包含物件的預存存取原則。

核心 GA
az storage share policy show

在包含的物件上顯示預存存取原則。

核心 GA
az storage share policy update

在包含的物件上設定預存存取原則。

核心 GA
az storage share show

傳回指定共用的所有使用者定義元數據和系統屬性。

核心 GA
az storage share snapshot

在指定的帳戶下建立現有共用的快照集。

核心 GA
az storage share stats

取得儲存在共用上的大約數據大小,四捨五入為最接近的 GB。

核心 GA
az storage share update

設定指定共用的服務定義屬性。

核心 GA
az storage share url

建立 URI 以存取檔案共用。

核心 GA

az storage share close-handle

關閉檔案共享的檔案句柄。

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

範例

以遞歸方式關閉檔案共用的所有檔句柄。

az storage share close-handle --account-name MyAccount --name MyFileShare --close-all --recursive
az storage share close-handle --account-name MyAccount --name MyFileShare --handle-id "*" --recursive

以遞歸方式關閉檔案目錄的所有檔句柄。

az storage share close-handle --account-name MyAccount --name MyFileShare --path 'dir1' --close-all --recursive

關閉檔案的所有檔案句柄。

az storage share close-handle --account-name MyAccount --name MyFileShare --path 'dir1/test.txt' --close-all

使用檔案的特定句柄標識碼關閉檔句柄。

az storage share close-handle --account-name MyAccount --name MyFileShare --path 'dir1/test.txt' --handle-id "id"

必要參數

--name -n

檔案共享名稱。

選擇性參數

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

是否要關閉所有檔句柄。 指定 close-all 或特定的 handle-id。

接受的值: false, true
--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。

--handle-id

指定要關閉之檔案或目錄上開啟的句柄標識碼。 Astrix ('*') 是指定所有句柄的通配符。

--path -p

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

--recursive

布爾值,指定作業是否應該套用至 URI 中指定的目錄、其檔案,以及其子目錄及其檔案。

接受的值: false, true
--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 share close-handle (storage-preview 擴充功能)

預覽

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

關閉檔案共用的檔案控制碼。

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

範例

以遞歸方式關閉檔案共用的所有檔句柄。

az storage share close-handle --account-name MyAccount --name MyFileShare --close-all --recursive
az storage share close-handle --account-name MyAccount --name MyFileShare --handle-id "*" --recursive

以遞歸方式關閉檔案目錄的所有檔句柄。

az storage share close-handle --account-name MyAccount --name MyFileShare --path 'dir1' --close-all --recursive

關閉檔案的所有檔案句柄。

az storage share close-handle --account-name MyAccount --name MyFileShare --path 'dir1/test.txt' --close-all

使用檔案的特定句柄標識碼關閉檔句柄。

az storage share close-handle --account-name MyAccount --name MyFileShare --path 'dir1/test.txt' --handle-id "id"

必要參數

--name -n

檔案共用名稱稱。

選擇性參數

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

是否要關閉所有檔案控制代碼。 指定 close-all 或特定的 handle-id。

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

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

--disallow-trailing-dot

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

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

指定要關閉之檔案或目錄上開啟的控制碼識別碼。 Astrix ('*') 是指定所有控制碼的萬用字元。

--path -p

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

--recursive

布林值,指定作業是否應該套用至 URI 中指定的目錄、其檔案,以及其子目錄及其檔案。

接受的值: false, true
--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 share create

在指定的帳號下建立新的共用。

az storage share create --name
                        [--account-key]
                        [--account-name]
                        [--connection-string]
                        [--fail-on-exist]
                        [--file-endpoint]
                        [--metadata]
                        [--quota]
                        [--sas-token]
                        [--timeout]

範例

在指定的帳號下建立新的共用。 (自動產生)

az storage share create --account-name MyAccount --name MyFileShare

必要參數

--name -n

檔案共用名稱稱。

選擇性參數

--account-key

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

--account-name

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

--connection-string

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

--fail-on-exist

指定共用存在時是否擲回例外狀況。 False 預設為 False。

預設值: False
--file-endpoint

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

--metadata

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

--quota

指定共用的大小上限,以 GB 為單位。 必須大於 0,且小於或等於 5TB (5120)。

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

標示要刪除的指定共用。

如果共用不存在,則服務上的作業會失敗。 根據預設,用戶端會吞沒例外狀況。 若要公開例外狀況,請針對 fail_not_exist 指定 True。

az storage share delete --name
                        [--account-key]
                        [--account-name]
                        [--connection-string]
                        [--delete-snapshots {include}]
                        [--fail-not-exist]
                        [--file-endpoint]
                        [--sas-token]
                        [--snapshot]
                        [--timeout]

必要參數

--name -n

檔案共享名稱。

選擇性參數

--account-key

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

--account-name

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

--connection-string

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

--delete-snapshots

指定共用具有快照集時的刪除策略。

接受的值: include
--fail-not-exist

指定當共用不存在時是否擲回例外狀況。 False 預設為 False。

預設值: False
--file-endpoint

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

--sas-token

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

--snapshot

表示快照集版本的字串,如果適用的話。指定這個自變數,只刪除特定的快照集。 如果指定delete_snapshots必須是 None。

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

檢查檔案共用是否存在。

az storage share exists --name
                        [--account-key]
                        [--account-name]
                        [--connection-string]
                        [--file-endpoint]
                        [--sas-token]
                        [--snapshot]
                        [--timeout]

範例

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

az storage share exists --account-key 00000000 --account-name MyAccount --name MyFileShare

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

az storage share exists --connection-string $connectionString --name MyFileShare

必要參數

--name -n

檔案共享名稱。

選擇性參數

--account-key

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

--account-name

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

--connection-string

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

--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 share generate-sas

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

az storage share generate-sas --name
                              [--account-key]
                              [--account-name]
                              [--cache-control]
                              [--connection-string]
                              [--content-disposition]
                              [--content-encoding]
                              [--content-language]
                              [--content-type]
                              [--expiry]
                              [--file-endpoint]
                              [--https-only]
                              [--ip]
                              [--permissions]
                              [--policy-name]
                              [--start]

範例

產生檔案共用的SAS令牌,並用它來上傳檔案。

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
sas=`az storage share generate-sas -n MyShare --account-name MyStorageAccount --https-only --permissions dlrw --expiry $end -o tsv`
az storage file upload -s MyShare --account-name MyStorageAccount --source file.txt  --sas-token $sas

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

az storage share generate-sas --account-key 00000000 --account-name MyStorageAccount --expiry 2037-12-31T23:59:00Z --name MyShare --permissions dlrw

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

az storage share generate-sas --connection-string $connectionString --expiry 2019-02-01T12:20Z --name MyShare --permissions dlrw

必要參數

--name -n

檔案共享名稱。

選擇性參數

--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 的響應標頭值。

--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 (l)ist (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 share list

列出儲存體帳戶中的檔案共用。

az storage share list [--account-key]
                      [--account-name]
                      [--connection-string]
                      [--file-endpoint]
                      [--include-metadata]
                      [--include-snapshots]
                      [--marker]
                      [--num-results]
                      [--prefix]
                      [--sas-token]
                      [--timeout]

選擇性參數

--account-key

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

--account-name

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

--connection-string

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

--file-endpoint

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

--include-metadata

指定在回應中傳回共享元數據。

預設值: False
--include-snapshots

指定在回應中傳回共用快照集。

預設值: False
--marker

不透明的接續令牌。 如果指定了num_results,且該產生器已完成列舉結果,則可以從上一個產生器物件的next_marker字段擷取此值。 如果指定,這個產生器會從前一個產生器停止的點開始傳回結果。

--num-results

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

預設值: 5000
--prefix

篩選結果,只傳回名稱開頭為指定前置詞的 Blob。

--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 share list-handle

列出檔案共用的檔案控制碼。

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

範例

以遞迴方式列出檔案共用的所有檔案控制碼。

az storage share list-handle --account-name MyAccount --name MyFileShare --recursive

以遞迴方式列出檔案目錄的所有檔案控制代碼。

az storage share list-handle --account-name MyAccount --name MyFileShare --path 'dir1' --recursive

列出檔案的所有檔案控制碼。

az storage share list-handle --account-name MyAccount --name MyFileShare --path 'dir1/test.txt'

必要參數

--name -n

檔案共用名稱稱。

選擇性參數

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

--marker

不透明的接續權杖。 如果已指定max_results且該產生器已完成列舉結果,則可以從先前產生器物件的next_marker欄位擷取此值。 如果指定,這個產生器會從前一個產生器停止的點開始傳回結果。

--max-results

指定要傳回之檔案和/或目錄的控制碼數目上限。 如果要求未指定max_results或指定大於 5,000 的值,伺服器將傳回最多 5,000 個專案。 將max_results設定為小於或等於零的值,會導致錯誤回應碼 400 (不正確的要求)。

--path -p

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

--recursive

布林值,指定作業是否應該套用至 URI 中指定的目錄、其檔案,以及其子目錄及其檔案。

接受的值: false, true
--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 share list-handle (storage-preview 擴充功能)

預覽

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

列出檔案共用的檔案控制碼。

az storage share list-handle --name
                             [--account-key]
                             [--account-name]
                             [--auth-mode {key, login}]
                             [--backup-intent]
                             [--connection-string]
                             [--disallow-trailing-dot {false, true}]
                             [--marker]
                             [--max-results]
                             [--path]
                             [--recursive {false, true}]
                             [--sas-token]
                             [--snapshot]
                             [--timeout]

範例

以遞迴方式列出檔案共用的所有檔案控制碼。

az storage share list-handle --account-name MyAccount --name MyFileShare --recursive

以遞迴方式列出檔案目錄的所有檔案控制代碼。

az storage share list-handle --account-name MyAccount --name MyFileShare --path 'dir1' --recursive

列出檔案的所有檔案控制碼。

az storage share list-handle --account-name MyAccount --name MyFileShare --path 'dir1/test.txt'

必要參數

--name -n

檔案共用名稱稱。

選擇性參數

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

不透明的接續權杖。 如果已指定max_results且該產生器已完成列舉結果,則可以從先前產生器物件的next_marker欄位擷取此值。 如果指定,這個產生器會從前一個產生器停止的點開始傳回結果。

--max-results

指定要傳回之檔案和/或目錄的控制碼數目上限。 如果要求未指定max_results或指定大於 5,000 的值,伺服器將傳回最多 5,000 個專案。 將max_results設定為小於或等於零的值,會導致錯誤回應碼 400 (不正確的要求)。

--path -p

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

--recursive

布林值,指定作業是否應該套用至 URI 中指定的目錄、其檔案,以及其子目錄及其檔案。

接受的值: false, true
--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 share show

傳回指定共用的所有使用者定義中繼資料和系統屬性。

傳回的資料不包含共用的檔案或目錄清單。

az storage share show --name
                      [--account-key]
                      [--account-name]
                      [--connection-string]
                      [--file-endpoint]
                      [--sas-token]
                      [--snapshot]
                      [--timeout]

必要參數

--name -n

檔案共用名稱稱。

選擇性參數

--account-key

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

--account-name

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

--connection-string

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

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

在指定的帳戶下建立現有共用的快照集。

az storage share snapshot --name
                          [--account-key]
                          [--account-name]
                          [--connection-string]
                          [--file-endpoint]
                          [--metadata]
                          [--quota]
                          [--sas-token]
                          [--timeout]

必要參數

--name -n

檔案共享名稱。

選擇性參數

--account-key

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

--account-name

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

--connection-string

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

--file-endpoint

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

--metadata

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

--quota

指定共用的大小上限,以 GB 為單位。 必須大於 0,且小於或等於 5 TB(5120 GB)。

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

取得儲存在共用上的大約數據大小,四捨五入為最接近的 GB。

請注意,此值可能不會包含最近建立或最近重新重設大小的檔案。

az storage share stats --name
                       [--account-key]
                       [--account-name]
                       [--connection-string]
                       [--file-endpoint]
                       [--sas-token]
                       [--timeout]

必要參數

--name -n

檔案共享名稱。

選擇性參數

--account-key

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

--account-name

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

--connection-string

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

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

設定指定共用的服務定義屬性。

az storage share update --name
                        --quota
                        [--account-key]
                        [--account-name]
                        [--connection-string]
                        [--file-endpoint]
                        [--sas-token]
                        [--timeout]

必要參數

--name -n

檔案共享名稱。

--quota

指定共用的大小上限,以 GB 為單位。 必須大於 0,且小於或等於 5 TB(5120 GB)。

選擇性參數

--account-key

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

--account-name

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

--connection-string

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

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

建立 URI 以存取檔案共用。

az storage share url --name
                     [--account-key]
                     [--account-name]
                     [--connection-string]
                     [--file-endpoint]
                     [--protocol {http, https}]
                     [--sas-token]
                     [--unc]

範例

建立 URI 以存取檔案共用。 ( 自動產生 )

az storage share url --account-key 00000000 --account-name MyAccount --name MyFileShare

必要參數

--name -n

檔案共享名稱。

選擇性參數

--account-key

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

--account-name

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

--connection-string

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

--file-endpoint

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

--protocol

要使用的通訊協定。

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

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

--unc

輸出 UNC 網路路徑。

預設值: 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 來取得完整偵錯記錄。