使用 AzCopy v10 取代 Blob 屬性和元數據
您可以使用 AzCopy 來變更一或多個 Blob 的存取層，並取代 (覆寫) 中繼資料，以及一或多個 Blob 的索引標籤。
開始使用
請參閱開始使用 AzCopy (部分機器翻譯) 一文來下載 AzCopy，並了解如何提供授權認證給儲存體服務。
注意
本文中的範例假設您已使用 Microsoft Entra ID 提供授權認證。
如果您想改為使用 SAS 權杖來授權存取 Blob 資料，則可將該權杖附加至每個 AzCopy 命令中的資源 URL。 例如： 'https://<storage-account-name>.blob.core.windows.net/<container-name><SAS-token>' 。
變更存取層
若要變更 Blob 的存取層，請使用 azcopy set-properties 命令，並將 -block-blob-tier 參數設定為存取層的名稱。
提示
此範例會以單引號 ('') 括住路徑引數。 除了 Windows 命令殼層 (cmd.exe) 以外，在所有命令殼層中使用單引號。 如果您使用 Windows 命令殼層 (cmd.exe)，請使用雙引號 ("") 括住路徑引數，而非單引號 ('')。
語法
azcopy set-properties 'https://<storage-account-name>.blob.core.windows.net/<container-name>/<blob-name>' --block-blob-tier=<access-tier>
範例
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --block-blob-tier=hot
若要變更虛擬目錄中所有 Blob 的存取層，請參閱虛擬目錄名稱，而不是 Blob 名稱，然後將 --recursive=true 附加至命令。
範例
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myvirtualdirectory' --block-blob-tier=hot --recursive=true
若要將 Blob 從封存層解除凍結至線上層，請將 --rehydrate-priority 設定為 standard 或 high。 根據預設，此參數設定為 standard。 若要深入了解每個選項的取捨，請參閱解除凍結優先順序。
範例
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --block-blob-tier=hot --rehydrate-priority=high
取代中繼資料
若要取代 Blob 的中繼資料，請使用 azcopy set-properties 命令，並將 --metadata 參數設定為一或多個索引鍵/值組。
提示
此範例會以單引號 ('') 括住路徑引數。 除了 Windows 命令殼層 (cmd.exe) 以外，在所有命令殼層中使用單引號。 如果您使用 Windows 命令殼層 (cmd.exe)，請使用雙引號 ("") 括住路徑引數，而非單引號 ('')。
語法
azcopy set-properties 'https://<storage-account-name>.blob.core.windows.net/<container-name>/<blob-name>' --metadata=<key>=<value>;<key>=<value>
範例
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --metadata=mykey1=myvalue1;mykey2=myvalue2
若要取代虛擬目錄中所有 Blob 的中繼資料，請參閱虛擬目錄名稱，而不是 Blob 名稱，然後將 --recursive=true 附加至命令。
範例
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myvirtualdirectory' --metadata=mykey1=myvalue1;mykey2=myvalue2 --recursive=true
若要清除中繼資料，請省略標記並附加 --metadata=clear 至命令結尾。
範例
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --metadata=clear
取代索引標籤
若要取代 Blob 的索引標記，請使用 azcopy set-properties 命令，並將 --blob-tags 參數設定為一或多個索引鍵/值組。 儲存體 Blob 資料擁有者，以及具有共用存取簽章且擁有存取 Blob 標籤權限 (t SAS 權限) 的任何人都可以設定 Blob 索引標籤。 此外，具有 Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write 權限的 RBAC 使用者也可以執行這項作業。
提示
此範例會以單引號 ('') 括住路徑引數。 除了 Windows 命令殼層 (cmd.exe) 以外，在所有命令殼層中使用單引號。 如果您使用 Windows 命令殼層 (cmd.exe)，請使用雙引號 ("") 括住路徑引數，而非單引號 ('')。
語法
azcopy set-properties 'https://<storage-account-name>.blob.core.windows.net/<container-name>/<blob-name>' --blob-tags=<tag>=<value>;<tag>=<value>
範例
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myTextFile.txt' --blob-tags=mytag1=mytag1value;mytag2=mytag2value
若要取代虛擬目錄中所有 Blob 的索引標記，請參閱虛擬目錄名稱，而不是 Blob 名稱，然後將 --recursive=true 附加至命令。
範例
azcopy set-properties 'https://mystorageaccount.blob.core.windows.net/mycontainer/myvirtualdirectory' --blob-tags=mytag1=mytag1value;mytag2=mytag2value
下一步
如需更多範例，請參閱以下文章：
- 範例：上傳
- 範例：下載
- 範例：在帳戶之間複製
- 範例：同步處理
- 範例：Amazon S3 貯體
- 範例：Google Cloud Storage
- 範例：Azure 檔案儲存體 (部分機器翻譯)
- 教學課程：使用 AzCopy 將內部部署資料移轉至雲端儲存體
請參閱下列文章，以進行設定、將效能最佳化，以及針對問題進行疑難排解：