你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az storage share

  • 参考

注意

此命令组具有在 Azure CLI 和至少一个扩展中定义的命令。 安装每个扩展，使其受益于其扩展功能。 详细了解扩展。

管理文件共享。

命令

名称 说明 类型 状态
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

获取存储在共享上的数据的大致大小，向上舍入到最接近的千兆字节。

 核心 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

使用文件的特定句柄 ID 关闭文件句柄。

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

是否关闭所有文件句柄。 指定完全关闭或特定的句柄 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_标准版RVICE_ENDPOINT。

--handle-id

指定要关闭的文件或目录上打开的句柄 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

订阅的名称或 ID。 可以使用 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

使用文件的特定句柄 ID 关闭文件句柄。

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

是否关闭所有文件句柄。 指定完全关闭或特定的句柄 ID。

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

存储帐户连接字符串。 环境变量：AZURE_STORAGE_CONNECTION_STRING。

--disallow-trailing-dot

如果为 true，将从目标 URI 中剪裁尾随点。 默认值为 False。

接受的值: false, true
默认值: False
--handle-id

指定要关闭的文件或目录上打开的句柄 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

订阅的名称或 ID。 可以使用 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
--file-endpoint

存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show。 环境变量：AZURE_STORAGE_标准版RVICE_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

订阅的名称或 ID。 可以使用 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
--file-endpoint

存储数据服务终结点。 必须与存储帐户密钥或 SAS 令牌结合使用。 可以使用 .. 查找每个服务主终结点 az storage account show。 环境变量：AZURE_STORAGE_标准版RVICE_ENDPOINT。

--sas-token

共享访问签名（SAS）。 必须与存储帐户名称或服务终结点结合使用。 环境变量：AZURE_STORAGE_SAS_TOKEN。

--snapshot

表示快照版本的字符串（如果适用）。指定此参数以仅删除特定快照。 如果指定了delete_快照，则必须为 None。

--timeout

请求超时（以秒为单位）。 适用于对服务的每个调用。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 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_标准版RVICE_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

订阅的名称或 ID。 可以使用 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-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_标准版RVICE_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

订阅的名称或 ID。 可以使用 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_标准版RVICE_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

订阅的名称或 ID。 可以使用 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_标准版RVICE_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

订阅的名称或 ID。 可以使用 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

订阅的名称或 ID。 可以使用 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_标准版RVICE_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

订阅的名称或 ID。 可以使用 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_标准版RVICE_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

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az storage share stats

编辑

获取存储在共享上的数据的大致大小，向上舍入到最接近的千兆字节。

请注意，此值可能不包括最近创建或最近重新调整大小的文件。

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_标准版RVICE_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

订阅的名称或 ID。 可以使用 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_标准版RVICE_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

订阅的名称或 ID。 可以使用 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_标准版RVICE_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

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。