你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
azcopy set-properties
给定位置后，更改该存储（blob 或文件）的所有有效系统属性。
摘要
azcopy set-properties [resourceURL] [flags]
设置 Blob 和文件存储的属性。 此命令当前支持的属性包括：
- Blob -> 层、元数据、标记
- Data Lake Storage Gen2 -> 层、元数据、标记
- 文件 -> 元数据
注意
Data Lake Storage 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=cold
将 Blob 层从热层更改为存档：
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=archive
将 Blob 层从存档层更改为冷层，并将解除冻结优先级设置为高：
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=cool --rehydrate-priority=high
将 blob 层从冷层更改为热层，并将优先级设置为标准：
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=hot --rehydrate-priority=standard
将目录中所有文件的层更改为存档层：
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --block-blob-tier=archive --recursive=true
更改页 Blob 的层：
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --page-blob-tier=[P10/P15/P20/P30/P4/P40/P50/P6]--rehydrate-priority=[Standard/High]
将 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
清除所有文件中的所有现有元数据：
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --recursive --metadata=clear
将 blob 的 blob-tags 更改为 {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 还有其他权限（标记为“t”）。 如果没有这些标记，服务将返回授权错误。
清除 blob 的所有现有 blob 标记：
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --blob-tags=clear
在 blob 上设置标记时，SAS 还有其他权限（标记为“t”）。 如果没有这些标记，服务将返回授权错误。
选项
--blob-tags 字符串在 Blob 上设置标记以对存储帐户中的数据进行分类（由“&”分隔）
--block-blob-tier 字符串将 blob 的访问层更改为给定层（默认值为“None”）
--dry-run 打印受此命令影响的文件路径。 此标记不会影响实际文件。
--exclude-path 字符串在移除时排除这些路径。 此选项不支持通配符 (*)。 检查相对路径前缀。 例如：myFolder;myFolder/subDirName/file.pdf
--exclude-pattern 字符串排除名称与模式列表相匹配的文件。 例如： .jpg; .pdf;exactName
--from-to 字符串（可选）指定源目标组合。 有效值：BlobNone、FileNone、BlobFSNone
有关 set-properties 的 -h、--help 帮助
--include-path 字符串在设置属性时仅包括这些路径。 此选项不支持通配符 (*)。 检查相对路径前缀。 例如：myFolder;myFolder/subDirName/file.pdf
--include-pattern 字符串仅包括名称与模式列表相匹配的文件。 例如： .jpg; .pdf;exactName
--list-of-files 字符串定义文本文件的位置，该文件包含要复制的文件的列表。
--metadata 字符串使用这些键值对（由“;”分隔）将给定位置设置为元数据。
--page-blob-tier 字符串使用此 blob 层将页 blob 上传到 Azure 存储。 （默认值为“None”）。 （默认值为“None”）
--recursive 从本地文件系统上传时以递归方式检查子目录。
--rehydrate-priority 字符串可选标记，用于设置解除冻结的解除冻结优先级。 有效值：Standard、High。 Default- standard（默认“Standard”）
从父命令继承的选项
--cap-mbps float限定传输速率，以 Mbps（兆位/秒）为单位。 瞬间吞吐量可能与上限略有不同。 如果此选项设置为零或被省略，则吞吐量不受限制。
--log-level（字符串）定义日志文件的日志详细程度，可用级别：INFO（所有请求/响应）、WARNING（响应缓慢）、ERROR（仅限失败的请求）和 NONE（无输出日志）。 （默认值为“INFO”）。 （默认值为“INFO”）
--output-type（字符串）命令输出的格式。 选项包括：text、json。 默认值为“text”。 （默认值为“text”）
--output-level（字符串）定义输出详细程度。 可用级别：essential、quiet。 （默认值“default”）
--trusted-microsoft-suffixes（字符串）指定可在其中发送 Microsoft Entra ID 登录令牌的其他域后缀。 默认值为“.core.windows.net;.core.chinacloudapi.cn;.core.cloudapi.de;.core.usgovcloudapi.net;*.storage.azure.net”。 此处列出的任何内容都会添加到默认值。 为安全起见，应只在此处放置 Microsoft Azure 域。 用分号分隔多个条目。