你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
az sig
注意
此命令组具有在 Azure CLI 和至少一个扩展中定义的命令。 安装每个扩展,使其受益于其扩展功能。 详细了解扩展。
管理共享映像库。
命令
az sig create
创建共享映像库。
az sig create --gallery-name
--resource-group
[--description]
[--eula]
[--location]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--permissions {Community, Groups, Private}]
[--public-name-prefix]
[--publisher-contact]
[--publisher-uri]
[--soft-delete {0, 1, f, false, n, no, t, true, y, yes}]
[--tags]
示例
创建共享映像库
az sig create --resource-group MyResourceGroup --gallery-name MyGallery
必需参数
要删除的共享映像库的名称。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
可选参数
库的说明。
社区库发布者 eula。
未指定资源位置时,将使用资源组的位置。
不等待长时间运行的操作完成。
此属性允许指定共享库的权限。
社区库公共名称前缀。
社区库发布者联系人电子邮件。
社区库发布者 URI。
为此库中的资源启用软删除,允许在保留期内恢复这些资源。
空格分隔标记:key[=value] [key[=value] ...]。使用“”清除现有标记。 支持速记语法、json-file 和 yaml-file。 请尝试“??” 以显示更多内容。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az sig create (image-gallery 扩展)
az sig create --gallery-name
--resource-group
[--description]
[--eula]
[--location]
[--permissions {Community, Groups, Private}]
[--public-name-prefix]
[--publisher-email]
[--publisher-uri]
[--soft-delete {false, true}]
[--tags]
必需参数
库名称。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
可选参数
库的说明。
社区库许可协议和隐私声明。
Location。 az account list-locations
中的值。 可以使用 az configure --defaults location=<location>
配置默认位置。
此属性允许指定共享库的权限。
社区库公共名称前缀。
社区库发布者联系人电子邮件。
社区库发布者 URI。
为此库中的资源启用软删除,允许在保留期内恢复这些资源。
空格分隔标记:key[=value] [key[=value] ...]。使用“”清除现有标记。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az sig delete
删除共享映像库。
az sig delete [--gallery-name]
[--ids]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]
可选参数
要删除的共享映像库的名称。
一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。
不等待长时间运行的操作完成。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az sig list
列出资源组下的库。
az sig list [--max-items]
[--next-token]
[--resource-group]
可选参数
命令输出中要返回的项总数。 如果可用的项总数大于指定的值,则会在命令的输出中提供令牌。 若要恢复分页,请在后续命令的 --next-token
参数中提供令牌值。
用于指定开始分页的位置的令牌。 这是先前截断的响应中的令牌值。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az sig list-community
列出直接共享到订阅或租户的所有社区库。
az sig list-community [--location]
[--marker]
[--show-next-marker]
示例
列出在给定位置直接共享到订阅的社区库
az sig list-community --location myLocation
根据下一个标记列出直接共享到租户的分页社区库
az sig list-community --location myLocation --marker nextMarker
可选参数
Location。 az account list-locations
中的值。 可以使用 az configure --defaults location=<location>
配置默认位置。
一个字符串值,该值标识要在下一个列表操作中返回的容器列表部分。 如果列表操作未返回剩余的所有容器,则返回响应正文中的 NextMarker 值,该容器将随当前页一起列出。 如果指定,此生成器将从上一个生成器停止的点开始返回结果。
指定后,在结果中显示 nextMarker。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az sig list-shared
列出直接共享到订阅或租户的所有共享库。
az sig list-shared --location
[--max-items]
[--next-token]
[--shared-to {tenant}]
示例
列出在给定位置直接共享到订阅的共享库
az sig list-shared --location myLocation
列出在给定位置直接共享到租户的共享库
az sig list-shared --location myLocation --shared-to tenant
必需参数
Location。 az account list-locations
中的值。 可以使用 az configure --defaults location=<location>
配置默认位置。
可选参数
命令输出中要返回的项总数。 如果可用的项总数大于指定的值,则会在命令的输出中提供令牌。 若要恢复分页,请在后续命令的 --next-token
参数中提供令牌值。
用于指定开始分页的位置的令牌。 这是先前截断的响应中的令牌值。
用于确定执行列表操作时要提取的共享库的查询参数。 如果未指定,则按订阅 ID 列出。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az sig show
检索有关共享映像库的信息。
az sig show [--gallery-name]
[--ids]
[--resource-group]
[--select {Permissions}]
[--sharing-groups {0, 1, f, false, n, no, t, true, y, yes}]
[--subscription]
可选参数
要删除的共享映像库的名称。
一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
要应用于操作的 select 表达式。
用于查询共享库组的展开查询选项。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az sig show-community
按库公共名称获取社区库。
az sig show-community [--ids]
[--location]
[--name]
[--subscription]
可选参数
一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。
Location。 az account list-locations
中的值。 可以使用 az configure --defaults location=<location>
配置默认位置。
社区库的公共名称。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az sig show-community (image-gallery 扩展)
此命令是实验性的,正在开发中。 参考和支持级别: https://aka.ms/CLI_refstatus
获取已社区(预览版)的库。
获取已社区(个人预览版功能)的库,请通过电子邮件联系 sigpmdev@microsoft.com 社区映像库团队,以注册预览版(如果你有兴趣使用此功能)。
az sig show-community [--ids]
[--location]
[--public-gallery-name]
[--subscription]
示例
获取已位于给定位置的社区库。
az sig show-community --public-gallery-name publicGalleryName --location myLocation
可选参数
一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。
Location。 az account list-locations
中的值。 可以使用 az configure --defaults location=<location>
配置默认位置。
社区库的公共名称。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az sig show-shared
获取直接共享到订阅或租户的库。
az sig show-shared [--gallery-unique-name]
[--ids]
[--location]
[--subscription]
示例
获取已直接共享到给定位置中的订阅或租户的库。
az sig show-shared --gallery-unique-name MyGalleryUniqueName --location MyLocation
可选参数
共享库的唯一名称。
一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。
Location。 az account list-locations
中的值。 可以使用 az configure --defaults location=<location>
配置默认位置。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az sig update
更新共享映像库。
az sig update [--add]
[--eula]
[--force-string {0, 1, f, false, n, no, t, true, y, yes}]
[--gallery-name]
[--ids]
[--location]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--permissions {Community, Groups, Private}]
[--public-name-prefix]
[--publisher-contact]
[--publisher-uri]
[--remove]
[--resource-group]
[--set]
[--soft-delete {0, 1, f, false, n, no, t, true, y, yes}]
[--subscription]
示例
允许将库共享到订阅或租户
az sig update --resource-group myResourceGroup --gallery-name myGallery --permissions groups
将库从专用更新到社区
az sig update -g myResourceGroup --gallery-name myGallery --permissions Community --publisher-uri myPublisherUri --publisher-email myPublisherEmail --eula myEula --public-name-prefix myPublicNamePrefix
可选参数
通过指定路径和键值对将对象添加到对象列表。 示例:--add property.listProperty <key=value, string or JSON string>
。
社区库发布者 eula。
使用“set”或“add”时,保留字符串文本,而不是尝试转换为 JSON。
要删除的共享映像库的名称。
一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。
资源位置。
不等待长时间运行的操作完成。
此属性允许指定共享库的权限。
社区库公共名称前缀。
社区库发布者联系人电子邮件。
社区库发布者 URI。
从列表中删除属性或元素。 示例: --remove property.list <indexToRemove>
OR --remove propertyToRemove
.
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
通过指定要设置的属性路径和值来更新对象。 示例:--add property.listProperty <key=value, string or JSON string>
。
为此库中的资源启用软删除,允许在保留期内恢复这些资源。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az sig wait
将 CLI 置于等待状态,直到满足条件。
az sig wait [--created]
[--custom]
[--deleted]
[--exists]
[--expand {SharingProfile/Groups}]
[--gallery-name]
[--ids]
[--interval]
[--resource-group]
[--select {Permissions}]
[--subscription]
[--timeout]
[--updated]
可选参数
等待在“Succeeded”中使用“provisioningState”创建。
等待条件满足自定义 JMESPath 查询。 例如 provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running']。
等到删除为止。
等待资源存在。
要应用于操作的展开查询选项。
要删除的共享映像库的名称。
一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。
轮询间隔(以秒为单位)。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
要应用于操作的 select 表达式。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
最大等待(以秒为单位)。
等到 provisioningState 更新为“Succeeded”。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。