通过

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

az lock

管理 Azure 锁。

命令

名称 说明 类型 Status
az lock create

创建锁。

 Core GA
az lock delete

删除锁。

 Core GA
az lock list

列出锁信息。

 Core GA
az lock show

显示锁的属性。

 Core GA
az lock update

更新锁。

 Core GA

az lock create

编辑

创建锁。

锁可以存在于三个不同的范围：订阅、资源组和资源。 有关如何在不同级别添加锁，请参阅以下示例。

az lock create --lock-type {CanNotDelete, ReadOnly}
               --name
               [--namespace]
               [--notes]
               [--parent]
               [--resource --resource-name]
               [--resource-group]
               [--resource-type]

示例

创建只读订阅级别锁。

az lock create --name lockName --lock-type ReadOnly

创建只读资源组级别锁。

az lock create --name lockName --resource-group group --lock-type ReadOnly

在 vnet 资源上创建只读资源级别锁。

az lock create --name lockName --resource-group group --lock-type ReadOnly --resource-type \
    Microsoft.Network/virtualNetworks --resource myVnet

使用特定父级在子网资源上创建只读资源级别锁。

az lock create --name lockName --resource-group group --lock-type ReadOnly --resource-type \
    Microsoft.Network/subnets --parent virtualNetworks/myVnet --resource mySubnet

必需参数

--lock-type -t

锁限制的类型。

属性 值
接受的值: CanNotDelete, ReadOnly
--name -n

锁的名称。

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--namespace

提供程序命名空间（例如：“Microsoft.Provider”）。

--notes

有关此锁的说明。

--parent

父路径（例如：'resA/myA/resB/myB'）。

--resource --resource-name

正在锁定的资源的名称或 ID。 如果给定 ID，则不应提供其他资源参数。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

--resource-type

资源类型（例如：“resC”）。 还可以接受命名空间/类型格式（例如：“Microsoft.Provider/resC”。

全局参数
--debug

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

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

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

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

--subscription

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

--verbose

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

属性 值
默认值: False

az lock delete

编辑

删除锁。

锁可以存在于三个不同的范围：订阅、资源组和资源。 有关如何在不同级别删除锁，请参阅以下示例。

az lock delete [--ids]
               [--name]
               [--namespace]
               [--parent]
               [--resource --resource-name]
               [--resource-group]
               [--resource-type]

示例

删除订阅级别锁

az lock delete --name lockName

删除资源组级别锁

az lock delete --name lockName --resource-group group

删除资源级锁

az lock delete --name lockName --resource-group group --resource resourceName --resource-type resourceType

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

一个或多个资源 ID（以空格分隔）。 如果提供，则不应指定其他“资源 ID”参数。

--name -n

锁的名称。

--namespace

提供程序命名空间（例如：“Microsoft.Provider”）。

--parent

父路径（例如：'resA/myA/resB/myB'）。

--resource --resource-name

正在锁定的资源的名称或 ID。 如果给定 ID，则不应提供其他资源参数。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

--resource-type

资源类型（例如：“resC”）。 还可以接受命名空间/类型格式（例如：“Microsoft.Provider/resC”。

全局参数
--debug

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

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

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

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

--subscription

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

--verbose

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

属性 值
默认值: False

az lock list

编辑

列出锁信息。

az lock list [--filter-string]
             [--namespace]
             [--parent]
             [--resource --resource-name]
             [--resource-group]
             [--resource-type]

示例

列出 vnet 资源上的锁。 包括关联组和订阅中的锁。

az lock list --resource myvnet --resource-type Microsoft.Network/virtualNetworks -g group

列出订阅级别上的所有锁

az lock list

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--filter-string

用于限制结果的查询筛选器。

--namespace

提供程序命名空间（例如：“Microsoft.Provider”）。

--parent

父路径（例如：'resA/myA/resB/myB'）。

--resource --resource-name

正在锁定的资源的名称或 ID。 如果给定 ID，则不应提供其他资源参数。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

--resource-type

资源类型（例如：“resC”）。 还可以接受命名空间/类型格式（例如：“Microsoft.Provider/resC”。

全局参数
--debug

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

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

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

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

--subscription

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

--verbose

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

属性 值
默认值: False

az lock show

编辑

显示锁的属性。

az lock show [--ids]
             [--name]
             [--namespace]
             [--parent]
             [--resource --resource-name]
             [--resource-group]
             [--resource-type]

示例

显示订阅级别锁

az lock show -n lockname

显示锁的属性（自动生成）

az lock show --name lockname --resource-group MyResourceGroup --resource-name MyResource --resource-type Microsoft.Network/virtualNetworks

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

一个或多个资源 ID（以空格分隔）。 如果提供，则不应指定其他“资源 ID”参数。

--name -n

锁的名称。

--namespace

提供程序命名空间（例如：“Microsoft.Provider”）。

--parent

父路径（例如：'resA/myA/resB/myB'）。

--resource --resource-name

正在锁定的资源的名称或 ID。 如果给定 ID，则不应提供其他资源参数。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

--resource-type

资源类型（例如：“resC”）。 还可以接受命名空间/类型格式（例如：“Microsoft.Provider/resC”。

全局参数
--debug

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

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

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

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

--subscription

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

--verbose

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

属性 值
默认值: False

az lock update

编辑

更新锁。

az lock update [--ids]
               [--lock-type {CanNotDelete, ReadOnly}]
               [--name]
               [--namespace]
               [--notes]
               [--parent]
               [--resource --resource-name]
               [--resource-group]
               [--resource-type]

示例

使用新的备注和类型更新资源组级别锁

az lock update --name lockName --resource-group group --notes newNotesHere --lock-type CanNotDelete

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

一个或多个资源 ID（以空格分隔）。 如果提供，则不应指定其他“资源 ID”参数。

--lock-type -t

锁限制的类型。

属性 值
接受的值: CanNotDelete, ReadOnly
--name -n

锁的名称。

--namespace

提供程序命名空间（例如：“Microsoft.Provider”）。

--notes

有关此锁的说明。

--parent

父路径（例如：'resA/myA/resB/myB'）。

--resource --resource-name

正在锁定的资源的名称或 ID。 如果给定 ID，则不应提供其他资源参数。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。

--resource-type

资源类型（例如：“resC”）。 还可以接受命名空间/类型格式（例如：“Microsoft.Provider/resC”。

全局参数
--debug

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

属性 值
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性 值
默认值: False
--output -o

输出格式。

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

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

--subscription

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

--verbose

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

属性 值
默认值: False