azcopy set-properties （預覽）
指定位置時，請變更該記憶體的所有有效系統屬性（Blob 或檔案）。
概要
azcopy set-properties [resourceURL] [flags]
設定 Blob 和檔案記憶體的屬性。 此指令目前支援的屬性如下：
- Blob -> 階層、元數據、標記
- Data Lake 儲存體 Gen2 -> 層、元數據、標記
- 檔案 -> 元數據
注意
Data Lake 儲存體 Gen2 端點將會由 Blob 儲存體 端點取代。
如需詳細資訊，請參閱範例。
相關概念性文章
範例
將 Blob 層變更為經常性存取：
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=hot
將 Blob 層從封存變更為非經常性存取，並將優先順序設定為高：
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=cool --rehydrate-priority=high
將目錄中所有檔案的階層變更為封存：
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --block-blob-tier=archive --recursive=true
將 Blob 的元數據變更為 {key = “abc”， val = “def”} 和 {key = “ghi”， val = “jkl”}：
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --metadata=abc=def;ghi=jkl
將目錄中所有檔案的元數據變更為 {key = “abc”， val = “def”} 和 {key = “ghi”， val = “jkl”}：
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --metadata=abc=def;ghi=jkl --recursive=true
清除 Blob 的所有現有元資料：
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --metadata=clear
將 Blob 的 Blob 標記變更為 {key = “abc”， val = “def”} 和 {key = “ghi”， val = “jkl”}：
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --blob-tags=abc=def&ghi=jkl
在 Blob 上設定標籤時，SAS 還有其他許可權（不適用於標籤）。 如果沒有這些標籤，服務會傳回授權錯誤。
清除 Blob 的所有現有 Blob 標記：
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --blob-tags=clear
在 Blob 上設定標籤時，SAS 還有其他許可權（不適用於標籤）。 如果沒有這些標籤，服務會傳回授權錯誤。
選項。
--blob-tags string 設定 Blob 上的標記以分類記憶體帳戶中的數據（以 '&'分隔）
--block-blob-tier string 將 Blob 的存取層變更為指定的層（預設為 “None”）
--dry-run 列印受到此命令影響的檔案路徑。 此旗標不會影響實際檔案。
--exclude-path string 移除時排除這些路徑。 此選項不支援通配符 \。 檢查相對路徑前置詞。 例如：myFolder;myFolder/subDirName/file.pdf
--exclude-pattern string 排除名稱符合模式清單的檔案。 例如： .jpg;。Pdf;exactName
--from-to string 選擇性地指定來源目的地組合。 有效值：BlobNone、FileNone、BlobFSNone
-h、 --help set-properties 的說明
--include-path string 在設定屬性時只包含這些路徑。 此選項不支援通配符 \。 檢查相對路徑前置詞。 例如：myFolder;myFolder/subDirName/file.pdf
--include-pattern string 僅包含名稱符合模式清單的檔案。 例如： .jpg;。Pdf;exactName
--list-of-files string 定義要複製之檔案清單的文字檔位置。
--metadata string 使用這些索引鍵/值組（以 ';' 分隔）設定指定的位置作為元數據。
--page-blob-tierstring 使用這個 Blob 層將分頁 Blob 上傳至 Azure 儲存體。 （預設為 'None'）。 （預設值“None”）
--recursive 從本機文件系統上傳時，以遞歸方式查看子目錄。
--rehydrate-priority string 選擇性旗標，設定解除凍結的解除凍結優先順序。 有效值：標準、高。 預設值 - 標準 （預設 “Standard”）
繼承自父命令的選項
--cap-mbps float 以每秒 MB 為單位來限制傳輸速率。 暫時輸送量可能會與上限稍有不同。 如果此選項設定為零，或省略此選項，則不會限制輸送量。
--log-level （字串）定義記錄檔的記錄詳細資訊、可用的層級：INFO（所有要求/回應）、WARNING（慢速回應）、ERROR（僅失敗的要求），以及 NONE（沒有輸出記錄）。 （預設為 'INFO'）。 （預設“INFO”）
--output-type （字串）命令輸出的格式。 選項包括：text、json。 預設值為 『text』。 （預設 “text”）
--output-level （字串）定義輸出詳細資訊。 可用的層級：基本、無訊息。 （預設值 “default”）
--trusted-microsoft-suffixes （字串）指定其他網域後綴，其中可能會傳送 Microsoft Entra ID 登入令牌。 預設值為 『.core.windows.net;。core.chinacloudapi.cn;。core.cloudapi.de;。core.usgovcloudapi.net;*.storage.azure.net'。 此處所列的任何專案會新增至預設值。 基於安全性，您應該只在這裡放置 Microsoft Azure 網域。 使用分號分隔多個專案。