通过

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

az site

注释

此引用是Azure CLI的 site 扩展的一部分（版本 2.75.0 或更高版本）。 该扩展将在首次运行 az site 命令时自动安装。 了解更多关于扩展程序的信息。

管理网站。

命令

名称 说明 类型 Status
az site create

创建限定为资源组、订阅或服务组的站点资源。

 扩展 GA
az site delete

删除限定为资源组、订阅或服务组的现有站点资源。

 扩展 GA
az site list

列出限定为资源组、订阅或服务组的所有网站资源。

 扩展 GA
az site show

显示限定为资源组、订阅或服务组的特定站点资源的详细信息。

 扩展 GA
az site update

更新限定为资源组、订阅或服务组的现有站点资源。

 扩展 GA

az site create

创建限定为资源组、订阅或服务组的站点资源。

范围选项：--resource-group：将站点范围限定为特定的资源组。 注意：使用此选项时，还必须提供 --subscription。 --subscription：将站点范围限定为订阅。 --service-group：将站点范围限定为服务组。

az site create --name --site-name
               [--acquire-policy-token]
               [--change-reference]
               [--city]
               [--country]
               [--description]
               [--display-name]
               [--labels]
               [--postal-code]
               [--resource-group]
               [--service-group --sg]
               [--state-or-province]
               [--street-address1]
               [--street-address2]

示例

在服务组范围内创建站点

az site create --site-name TestSiteName --service-group TestSGName --display-name 'Test Site Display' --description "Test Site" --labels key1="value1" key2="value2" --street-address1="16 TOWNSEND ST" --street-address2="UNIT 1" --city="newyork" --state-or-province="CA" --country="US" --postal-code="94107"

在资源组范围内创建站点

az site create --site-name TestSiteName --resource-group TestRGName --subscription 000000000-0000-0000-0000-000000000000 --display-name 'Test Site Display' --description "Test Site" --street-address1="16 TOWNSEND ST" --street-address2="UNIT 1" --city="newyork" --state-or-province="CA" --country="US" --postal-code="94107"

在订阅范围内创建站点

az site create --site-name TestSiteName --subscription 000000000-0000-0000-0000-000000000000 --display-name 'Test Site Display' --description "Test Site" --labels key1="value1" --street-address1="16 TOWNSEND ST" --street-address2="UNIT 1" --city="newyork" --state-or-province="CA" --country="US" --postal-code="94107"

必需参数

--name --site-name -n

站点资源的名称。

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--acquire-policy-token

为此资源操作自动获取Azure Policy令牌。

属性 值
参数组: Global Policy Arguments
--change-reference

此资源操作的相关更改引用 ID。

属性 值
参数组: Global Policy Arguments
--city

地址所在的城市。

属性 值
参数组: SiteAddress Arguments
--country

地址的国家/地区。

属性 值
参数组: SiteAddress Arguments
--description

站点资源的说明。

属性 值
参数组: Properties Arguments
--display-name

站点资源的显示名称。

属性 值
参数组: Properties Arguments
--labels

用于标记网站资源的键值对。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。

属性 值
参数组: Properties Arguments
--postal-code

地址的邮政编码。

属性 值
参数组: SiteAddress Arguments
--resource-group -g

资源组的名称。

--service-group --sg

服务组的名称。

--state-or-province

地址的州或省。

属性 值
参数组: SiteAddress Arguments
--street-address1

街道地址的第一行。

属性 值
参数组: SiteAddress Arguments
--street-address2

街道地址的第二行。

属性 值
参数组: SiteAddress Arguments
全局参数
--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 site delete

删除限定为资源组、订阅或服务组的现有站点资源。

范围选项：--resource-group：以特定资源组中的站点为目标。 注意：需要 --subscription。 --subscription：面向范围限定为订阅的网站。 --service-group：面向范围限定为服务组的站点。

az site delete --name --site-name
               [--acquire-policy-token]
               [--change-reference]
               [--resource-group]
               [--service-group --sg]
               [--yes]

示例

删除服务组范围内的站点

az site delete --site-name TestSiteName --service-group TestSGName

删除资源组范围内的站点

az site delete --site-name TestSiteName --resource-group TestRGName --subscription 00000000-0000-0000-0000-000000000000

删除订阅范围内的站点

az site delete --site-name TestSiteName --subscription 00000000-0000-0000-0000-000000000000

必需参数

--name --site-name -n

站点资源的名称。

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--acquire-policy-token

为此资源操作自动获取Azure Policy令牌。

属性 值
参数组: Global Policy Arguments
--change-reference

此资源操作的相关更改引用 ID。

属性 值
参数组: Global Policy Arguments
--resource-group -g

资源组的名称。

--service-group --sg

服务组的名称。

--yes -y

不请求确认。

属性 值
默认值: False
全局参数
--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 site list

列出限定为资源组、订阅或服务组的所有网站资源。

范围选项：--resource-group：列出特定资源组中的站点。 注意：需要 --subscription。 --subscription：列出范围限定为订阅的网站。 --service-group：列出范围限定为服务组的站点。

az site list [--max-items]
             [--next-token]
             [--resource-group]
             [--service-group --sg]

示例

列出服务组范围内的站点

az site list --service-group TestSGName

列出资源组范围内的站点

az site list --resource-group TestRGName --subscription 00000000000-0000-0000-0000-000000000000

列出订阅范围内的网站

az site list --subscription 00000000000-0000-0000-0000-000000000000

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--max-items

命令输出中要返回的项总数。 如果可用的项总数大于指定的值，则会在命令的输出中提供令牌。 若要恢复分页，请在后续命令的 --next-token 参数中提供令牌值。

属性 值
参数组: Pagination Arguments
--next-token

用于指定开始分页的位置的令牌。 这是先前截断的响应中的令牌值。

属性 值
参数组: Pagination Arguments
--resource-group -g

资源组的名称。

--service-group --sg

服务组的名称。

全局参数
--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 site show

显示限定为资源组、订阅或服务组的特定站点资源的详细信息。

范围选项：--resource-group：显示特定资源组中的站点详细信息。 注意：需要 --subscription。 --subscription：显示范围限定为订阅的网站详细信息。 --service-group：显示范围限定为服务组的网站详细信息。

az site show --name --site-name
             [--resource-group]
             [--service-group --sg]

示例

在服务组范围内显示站点

az site show --site-name TestSiteName --service-group TestSGName

在资源组范围内显示站点

az site show --site-name TestSiteName --resource-group TestRGName --subscription 00000000-0000-0000-0000-000000000000

在订阅范围内显示站点

az site show --site-name TestSiteName --subscription 00000000-0000-0000-0000-000000000000

必需参数

--name --site-name -n

站点资源的名称。

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--resource-group -g

资源组的名称。

--service-group --sg

服务组的名称。

全局参数
--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 site update

更新限定为资源组、订阅或服务组的现有站点资源。

范围选项：--resource-group：更新特定资源组中的站点。 注意：需要 --subscription。 --subscription：更新限定为订阅的网站。 --service-group：更新作用域为服务组的站点。

az site update --name --site-name
               [--acquire-policy-token]
               [--change-reference]
               [--city]
               [--country]
               [--description]
               [--display-name]
               [--labels]
               [--postal-code]
               [--resource-group]
               [--service-group --sg]
               [--state-or-province]
               [--street-address1]
               [--street-address2]

示例

更新服务组范围内的站点

az site update --site-name TestSiteName --service-group TestSGName --description "Test Site" --labels key1="value1" key2="value2" --street-address1="17 TOWNSEND ST" --street-address2="UNIT 2" --city="newyork" --state-or-province="CA" --country="US" --postal-code="94107"

更新资源组范围内的站点

az site update --site-name TestSiteName --resource-group TestMSRG --subscription 00000000-0000-0000-0000-000000000000 --description "Test Site" --labels key1="value1" key2="value2" --street-address1="17 TOWNSEND ST" --street-address2="UNIT 2" --city="newyork" --state-or-province="CA" --country="US" --postal-code="94107"

在订阅范围内更新站点

az site update --site-name TestSiteName  --subscription 00000000-0000-0000-0000-000000000000 --description "Test Site" --labels key1="value1" key2="value2" --street-address1="17 TOWNSEND ST" --street-address2="UNIT 2" --city="newyork" --state-or-province="CA" --country="US" --postal-code="94107"

必需参数

--name --site-name -n

站点资源的名称。

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--acquire-policy-token

为此资源操作自动获取Azure Policy令牌。

属性 值
参数组: Global Policy Arguments
--change-reference

此资源操作的相关更改引用 ID。

属性 值
参数组: Global Policy Arguments
--city

地址所在的城市。

属性 值
参数组: SiteAddress Arguments
--country

地址的国家/地区。

属性 值
参数组: SiteAddress Arguments
--description

站点资源的说明。

属性 值
参数组: Properties Arguments
--display-name

站点资源的 DisplayName。

属性 值
参数组: Properties Arguments
--labels

用于标记站点资源的键值对;若要删除标签，将其值设置为 null，或删除所有标签，请将 --label 设置为 null。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。

属性 值
参数组: Properties Arguments
--postal-code

地址的邮政编码。

属性 值
参数组: SiteAddress Arguments
--resource-group -g

资源组的名称。

--service-group --sg

服务组的名称。

--state-or-province

地址的州或省。

属性 值
参数组: SiteAddress Arguments
--street-address1

街道地址的第一行。

属性 值
参数组: SiteAddress Arguments
--street-address2

街道地址的第二行。

属性 值
参数组: SiteAddress Arguments
全局参数
--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