az storage directory metadata

注意

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

管理檔案儲存體目錄中繼資料。

命令

名稱	Description	類型	狀態
az storage directory metadata show	取得指定目錄的所有用戶定義元數據。	核心	GA
az storage directory metadata show (storage-preview 擴充功能)	取得指定目錄的所有用戶定義元數據。	副檔名	預覽版
az storage directory metadata update	為指定的目錄設定一或多個使用者定義的名稱/值組。	核心	GA
az storage directory metadata update (storage-preview 擴充功能)	為指定的目錄設定一或多個使用者定義的名稱/值組。	副檔名	預覽版

az storage directory metadata show

取得指定目錄的所有用戶定義元數據。

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

必要參數

--name -n

目錄名稱。

--share-name -s

檔案共享名稱。

選擇性參數

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login

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

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

預設值: False

--connection-string

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

--disallow-trailing-dot

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

接受的值: false, true

預設值: False

--file-endpoint

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

--sas-token

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

--snapshot

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

--timeout

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

全域參數

--debug

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

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

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

--subscription

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

--verbose

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

az storage directory metadata show (storage-preview 擴充功能)

預覽

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

取得指定目錄的所有用戶定義元數據。

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

必要參數

--name -n

目錄名稱。

--share-name -s

檔案共享名稱。

選擇性參數

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login

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

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

預設值: False

--connection-string

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

--disallow-trailing-dot

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

接受的值: false, true

預設值: False

--sas-token

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

--snapshot

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

--timeout

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

全域參數

--debug

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

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

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

--subscription

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

--verbose

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

az storage directory metadata update

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

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

必要參數

--name -n

目錄名稱。

--share-name -s

檔案共享名稱。

選擇性參數

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login

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

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

預設值: False

--connection-string

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

--disallow-trailing-dot

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

接受的值: false, true

預設值: False

--file-endpoint

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

--metadata

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

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

預覽

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

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

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

必要參數

--name -n

目錄名稱。

--share-name -s

檔案共用名稱稱。

選擇性參數

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login

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

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

預設值: False

--connection-string

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

--disallow-trailing-dot

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

接受的值: false, true

預設值: False

--metadata

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

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