你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
az postgres server
管理 PostgreSQL 服务器。
命令
az postgres server create
创建服务器。
az postgres server create [--admin-password]
[--admin-user]
[--assign-identity]
[--auto-grow {Disabled, Enabled}]
[--backup-retention]
[--geo-redundant-backup {Disabled, Enabled}]
[--infrastructure-encryption {Disabled, Enabled}]
[--location]
[--minimal-tls-version {TLS1_0, TLS1_1, TLS1_2, TLSEnforcementDisabled}]
[--name]
[--public]
[--resource-group]
[--sku-name]
[--ssl-enforcement {Disabled, Enabled}]
[--storage-size]
[--tags]
[--version]
示例
使用 sku GP_Gen5_2(常规用途、第 5 代硬件、2 个 vCore)在北欧创建 PostgreSQL 服务器。
az postgres server create -l northeurope -g testgroup -n testsvr -u username -p password \
--sku-name GP_Gen5_2
使用所有参数集创建 PostgreSQL 服务器。
az postgres server create -l northeurope -g testgroup -n testsvr -u username -p password \
--sku-name B_Gen5_1 --ssl-enforcement Enabled --minimal-tls-version TLS1_0 --public-network-access Disabled \
--backup-retention 10 --geo-redundant-backup Enabled --storage-size 51200 \
--tags "key=value" --version 11
可选参数
管理员的密码。 最少 8 个字符,最多 128 个字符。 密码必须包含以下类别中的三个类别的字符:英文大写字母、英文小写字母、数字和非字母数字字符。
服务器管理员istrator 用户名。 设置后,无法更改它。
为此服务器生成并分配 Azure Active Directory 标识,以用于 Azure KeyVault 等密钥管理服务。
启用或禁用存储的自动增长。 默认值为“已启用”。
备份保留的天数。 范围为 7 到 35 天。 默认值为 7 天。
启用或禁用异地冗余备份。 默认值为 Disabled。 基本定价层不支持。
使用新的加密算法为数据添加可选的第二层加密。 默认值为 Disabled。
Location。 az account list-locations
中的值。 可以使用 az configure --defaults location=<location>
配置默认位置。
启用 SSL 时,为连接到服务器的最小 TLS 版本设置。 默认值为 TL标准版nforcementDisabled。
服务器的名称。 名称只能包含小写字母、数字和连字符 (-)。 最少 3 个字符,最多 63 个字符。
启用或禁用对服务器的公用网络访问。 禁用后,只有通过专用链接建立的连接才能访问此服务器。 允许的值为:Enabled、Disabled、all、0.0.0.0、、 。 默认值为“已启用”。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
SKU 的名称。 请遵循简写约定 {pricing tier} {compute generation} {vCores}。 示例:B_Gen5_1、GP_Gen5_4、MO_Gen5_16。
启用或禁用与服务器的连接的 ssl 强制实施。 默认值为“已启用”。
服务器的存储容量(以 MB 为单位)。 最小值为 5120,以 1024 为增量递增。 默认值为 5120。
空格分隔标记:key[=value] [key[=value] ...]。使用“”清除现有标记。
服务器主版本。 https://docs.microsoft.com/en-us/azure/postgresql/single-server/concepts-supported-versions。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az postgres server delete
删除服务器。
az postgres server delete [--ids]
[--name]
[--resource-group]
[--subscription]
[--yes]
示例
删除服务器。
az postgres server delete -g testgroup -n testsvr
可选参数
一个或多个资源 ID(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
服务器的名称。 名称只能包含小写字母、数字和连字符 (-)。 最少 3 个字符,最多 63 个字符。
资源组的名称。 可以使用 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 postgres server georestore
从备份异地还原服务器。
az postgres server georestore --location
--source-server
[--backup-retention]
[--geo-redundant-backup]
[--ids]
[--name]
[--no-wait]
[--resource-group]
[--sku-name]
[--subscription]
示例
将“testsvr”异地还原到位于美国西部 2 的新服务器“testsvrnew”。
az postgres server georestore -g testgroup -n testsvrnew --source-server testsvr -l westus2
将“testsvr”异地还原到位于美国西部 2 的新服务器“testsvrnew”,其 sku GP_Gen5_2。
az postgres server georestore -g testgroup -n testsvrnew --source-server testsvr -l westus2 --sku-name GP_Gen5_2
将“testsvr2”异地还原到新的服务器“testsvrnew”中,其中“testsvrnew”位于不同于“testsvr2”的资源组中。
az postgres server georestore -g testgroup -n testsvrnew \
-s "/subscriptions/${SubID}/resourceGroups/${ResourceGroup}/providers/Microsoft.DBforPostgreSQL/servers/testsvr2" \
-l westus2
必需参数
Location。 az account list-locations
中的值。 可以使用 az configure --defaults location=<location>
配置默认位置。
要从其还原的源服务器的名称或 ID。
可选参数
备份保留的天数。 范围为 7 到 35 天。 默认值为 7 天。
启用或禁用异地冗余备份。 默认值为 Disabled。 基本定价层不支持。
一个或多个资源 ID(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
服务器的名称。 名称只能包含小写字母、数字和连字符 (-)。 最少 3 个字符,最多 63 个字符。
不等待长时间运行的操作完成。
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
SKU 的名称。 默认为源服务器的 SKU。 请遵循简写约定 {pricing tier} {compute generation} {vCores}。 示例:B_Gen5_1、GP_Gen5_4、MO_Gen5_16。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az postgres server list
列出可用的服务器。
az postgres server list [--resource-group]
示例
列出订阅中的所有 PostgreSQL 服务器。
az postgres server list
列出资源组中的所有 PostgreSQL 服务器。
az postgres server list -g testgroup
可选参数
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az postgres server list-skus
列出给定区域中的可用 SKU。
az postgres server list-skus --location
示例
列出给定区域中的可用 SKU。
az postgres server list-skus -l eastus
必需参数
位置的名称。 必需。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az postgres server restart
重启服务器。
az postgres server restart [--ids]
[--name]
[--resource-group]
[--subscription]
示例
重启服务器。
az postgres server restart -g testgroup -n testsvr
可选参数
一个或多个资源 ID(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
服务器的名称。 名称只能包含小写字母、数字和连字符 (-)。 最少 3 个字符,最多 63 个字符。
资源组的名称。 可以使用 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 postgres server restore
从备份还原服务器。
az postgres server restore --pitr-time
--source-server
[--ids]
[--name]
[--no-wait]
[--resource-group]
[--subscription]
示例
将“testsvr”还原到作为新服务器“testsvrnew”的特定时间点。
az postgres server restore -g testgroup -n testsvrnew --source-server testsvr --restore-point-in-time "2017-06-15T13:10:00Z"
将“testsvr2”还原到“testsvrnew”,其中“testsvrnew”位于不同于“testsvr2”的资源组中。
az postgres server restore -g testgroup -n testsvrnew \
-s "/subscriptions/${SubID}/resourceGroups/${ResourceGroup}/providers/Microsoft.DBforPostgreSQL/servers/testsvr2" \
--restore-point-in-time "2017-06-15T13:10:00Z"
必需参数
从 UTC 还原的时间点(ISO8601格式),例如 2017-04-26T02:10:00+08:00。
要从中还原的源服务器的名称或资源 ID。
可选参数
一个或多个资源 ID(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
服务器的名称。 名称只能包含小写字母、数字和连字符 (-)。 最少 3 个字符,最多 63 个字符。
不等待长时间运行的操作完成。
资源组的名称。 可以使用 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 postgres server show
获取服务器的详细信息。
az postgres server show [--ids]
[--name]
[--resource-group]
[--subscription]
示例
获取服务器的详细信息。 (自动生成)
az postgres server show --name MyServer --resource-group MyResourceGroup
可选参数
一个或多个资源 ID(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
服务器的名称。 名称只能包含小写字母、数字和连字符 (-)。 最少 3 个字符,最多 63 个字符。
资源组的名称。 可以使用 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 postgres server show-connection-string
显示 PostgreSQL 服务器数据库的连接字符串。
az postgres server show-connection-string [--admin-password]
[--admin-user]
[--database-name]
[--ids]
[--server-name]
[--subscription]
示例
显示 cmd 和编程语言的连接字符串。
az postgres server show-connection-string -s testServer -u username -p password -d databasename
可选参数
管理员的登录密码。
管理员的登录用户名。
数据库的名称。
一个或多个资源 ID(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
服务器的名称。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az postgres server update
更新服务器。
az postgres server update [--add]
[--admin-password]
[--assign-identity]
[--auto-grow {Disabled, Enabled}]
[--backup-retention]
[--force-string]
[--ids]
[--minimal-tls-version {TLS1_0, TLS1_1, TLS1_2, TLSEnforcementDisabled}]
[--name]
[--public]
[--remove]
[--resource-group]
[--set]
[--sku-name]
[--ssl-enforcement {Disabled, Enabled}]
[--storage-size]
[--subscription]
[--tags]
示例
更新服务器的 SKU。
az postgres server update -g testgroup -n testsvrnew --sku-name GP_Gen5_4
更新服务器的标记。
az postgres server update -g testgroup -n testsvrnew --tags "k1=v1" "k2=v2"
更新服务器。 (自动生成)
az postgres server update --name testsvrnew --resource-group testgroup --ssl-enforcement Enabled --minimal-tls-version TLS1_0
可选参数
通过指定路径和键值对将对象添加到对象列表。 示例:--add property.listProperty <key=value, string or JSON string>
。
管理员的密码。 最少 8 个字符,最多 128 个字符。 密码必须包含以下类别中的三个类别的字符:英文大写字母、英文小写字母、数字和非字母数字字符。
为此服务器生成并分配 Azure Active Directory 标识,以用于 Azure KeyVault 等密钥管理服务。
启用或禁用存储的自动增长。 默认值为“已启用”。
备份保留的天数。 范围为 7 到 35 天。 默认值为 7 天。
使用“set”或“add”时,保留字符串文本,而不是尝试转换为 JSON。
一个或多个资源 ID(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
启用 SSL 时,为连接到服务器的最小 TLS 版本设置。 默认值为 TL标准版nforcementDisabled。
服务器的名称。 名称只能包含小写字母、数字和连字符 (-)。 最少 3 个字符,最多 63 个字符。
启用或禁用对服务器的公用网络访问。 禁用后,只有通过专用链接建立的连接才能访问此服务器。 允许的值为:Enabled、Disabled、all、0.0.0.0、、 。 默认值为“已启用”。
从列表中删除属性或元素。 示例: --remove property.list <indexToRemove>
OR --remove propertyToRemove
.
资源组的名称。 可以使用 az configure --defaults group=<name>
配置默认组。
通过指定要设置的属性路径和值来更新对象。 示例:--set property1.property2=<value>
。
SKU 的名称。 请遵循简写约定 {pricing tier} {compute generation} {vCores}。 示例:B_Gen5_1、GP_Gen5_4、MO_Gen5_16。
启用或禁用与服务器的连接的 ssl 强制实施。 默认值为“已启用”。
服务器的存储容量(以 MB 为单位)。 最小值为 5120,以 1024 为增量递增。 默认值为 5120。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
空格分隔标记:key[=value] [key[=value] ...]。使用“”清除现有标记。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误,取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID
配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az postgres server wait
等待服务器满足某些条件。
az postgres server wait [--custom]
[--exists]
[--ids]
[--interval]
[--name]
[--resource-group]
[--subscription]
[--timeout]
可选参数
等待条件满足自定义 JMESPath 查询。 例如 provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running']。
等待资源存在。
一个或多个资源 ID(以空格分隔)。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
轮询间隔(以秒为单位)。
服务器的名称。 名称只能包含小写字母、数字和连字符 (-)。 最少 3 个字符,最多 63 个字符。
资源组的名称。 可以使用 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 获取完整的调试日志。