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

az postgres

注意

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

管理 Azure Database for PostgreSQL 服务器。

命令

名称	说明	类型	状态
az postgres db	管理服务器上的 PostgreSQL 数据库。	核心	GA
az postgres db create	创建 PostgreSQL 数据库。	核心	GA
az postgres db delete	删除数据库。	核心	GA
az postgres db list	列出服务器的数据库。	核心	GA
az postgres db show	显示数据库的详细信息。	核心	GA
az postgres down	删除 PostgreSQL 服务器及其缓存的信息。	扩展	GA
az postgres flexible-server	管理 Azure Database for PostgreSQL 灵活服务器。	核心和扩展	GA
az postgres flexible-server ad-admin	管理服务器 Active Directory 管理员。	核心	GA
az postgres flexible-server ad-admin create	创建 Active Directory 管理员。	核心	GA
az postgres flexible-server ad-admin delete	删除 Active Directory 管理员。	核心	GA
az postgres flexible-server ad-admin list	列出所有 Active Directory 管理员。	核心	GA
az postgres flexible-server ad-admin show	获取 Active Directory 管理员。	核心	GA
az postgres flexible-server ad-admin wait	等待 Active Directory 管理员满足某些条件。	核心	GA
az postgres flexible-server advanced-threat-protection-setting	管理 PostgreSQL 灵活服务器的高级威胁防护设置。	核心	GA
az postgres flexible-server advanced-threat-protection-setting show	获取 PostgreSL 灵活服务器的高级威胁防护设置。	核心	GA
az postgres flexible-server advanced-threat-protection-setting update	汇报灵活服务器的高级威胁防护设置状态。	核心	GA
az postgres flexible-server backup	管理灵活的服务器备份。	核心	GA
az postgres flexible-server backup list	列出给定服务器的所有备份。	核心	GA
az postgres flexible-server backup show	显示给定服务器的特定备份的详细信息。	核心	GA
az postgres flexible-server connect	连接灵活服务器。	扩展	GA
az postgres flexible-server create	创建 PostgreSQL 灵活服务器。	核心	GA
az postgres flexible-server db	管理灵活服务器上的 PostgreSQL 数据库。	核心	GA
az postgres flexible-server db create	在灵活服务器上创建 PostgreSQL 数据库。	核心	GA
az postgres flexible-server db delete	删除灵活服务器上的数据库。	核心	GA
az postgres flexible-server db list	列出灵活服务器的数据库。	核心	GA
az postgres flexible-server db show	显示数据库的详细信息。	核心	GA
az postgres flexible-server delete	删除灵活服务器。	核心	GA
az postgres flexible-server deploy	为 PostgreSQL 服务器启用并运行 GitHub Actions 工作流。	核心	GA
az postgres flexible-server deploy run	在 github 存储库中运行现有工作流。	核心	GA
az postgres flexible-server deploy setup	为 PostgreSQL 服务器创建 GitHub Actions 工作流文件。	核心	GA
az postgres flexible-server execute	连接灵活服务器。	扩展	GA
az postgres flexible-server firewall-rule	管理服务器的防火墙规则。	核心	GA
az postgres flexible-server firewall-rule create	为灵活服务器创建新的防火墙规则。	核心	GA
az postgres flexible-server firewall-rule delete	删除防火墙规则。	核心	GA
az postgres flexible-server firewall-rule list	列出灵活服务器的所有防火墙规则。	核心	GA
az postgres flexible-server firewall-rule show	获取防火墙规则的详细信息。	核心	GA
az postgres flexible-server firewall-rule update	更新防火墙规则。	核心	GA
az postgres flexible-server geo-restore	从备份中异地还原灵活服务器。	核心	GA
az postgres flexible-server identity	管理服务器用户分配的标识。	核心	GA
az postgres flexible-server identity assign	将用户签名的托管标识添加到服务器。	核心	GA
az postgres flexible-server identity list	列出服务器中的所有用户分配的托管标识。	核心	GA
az postgres flexible-server identity remove	从服务器中删除用户签名的托管标识。	核心	GA
az postgres flexible-server identity show	从服务器获取用户分配的托管标识。	核心	GA
az postgres flexible-server list	列出可用的灵活服务器。	核心	GA
az postgres flexible-server list-skus	列出给定区域中的可用 SKU。	核心	GA
az postgres flexible-server migration	管理 PostgreSQL 灵活服务器的迁移工作流。	核心	GA
az postgres flexible-server migration check-name-availability	检查是否可以使用提供的迁移名称。	核心	GA
az postgres flexible-server migration create	为灵活服务器创建新的迁移工作流。	核心	GA
az postgres flexible-server migration list	列出灵活服务器的迁移。	核心	GA
az postgres flexible-server migration show	获取特定迁移的详细信息。	核心	GA
az postgres flexible-server migration update	更新特定迁移。	核心	GA
az postgres flexible-server parameter	用于管理灵活服务器的服务器参数值的命令。	核心	GA
az postgres flexible-server parameter list	列出灵活服务器的参数值。	核心	GA
az postgres flexible-server parameter set	更新灵活服务器的参数。	核心	GA
az postgres flexible-server parameter show	获取灵活服务器的参数。”	核心	GA
az postgres flexible-server private-endpoint-connection	管理 PostgreSQL 灵活服务器专用终结点连接。	核心	GA
az postgres flexible-server private-endpoint-connection approve	批准与 PostgreSQL 灵活服务器关联的指定专用终结点连接。	核心	GA
az postgres flexible-server private-endpoint-connection delete	删除与 PostgreSQL 灵活服务器关联的指定专用终结点连接。	核心	GA
az postgres flexible-server private-endpoint-connection list	列出与 PostgreSQL 灵活服务器关联的所有专用终结点连接。	核心	GA
az postgres flexible-server private-endpoint-connection reject	拒绝与 PostgreSQL 灵活服务器关联的指定专用终结点连接。	核心	GA
az postgres flexible-server private-endpoint-connection show	显示与 PostgreSQL 灵活服务器关联的专用终结点连接的详细信息。	核心	GA
az postgres flexible-server private-link-resource	获取 PostgreSQL 灵活服务器的专用链接资源。	核心	GA
az postgres flexible-server private-link-resource list	列出与 PostgreSQL 灵活服务器关联的专用链接资源。	核心	GA
az postgres flexible-server private-link-resource show	获取 PostgreSQL 灵活服务器的专用链接资源。	核心	GA
az postgres flexible-server replica	管理读取副本 (replica)。	核心	GA
az postgres flexible-server replica create	创建服务器的只读副本。	核心	GA
az postgres flexible-server replica list	列出某个给定服务器的所有只读副本。	核心	GA
az postgres flexible-server replica promote	停止读取副本 (replica)副本 (replica)并将其提升为独立服务器或主服务器。	核心	GA
az postgres flexible-server replica stop-replication	停止复制到只读副本，并使该副本成为读/写服务器。	核心	已放弃
az postgres flexible-server restart	重启灵活服务器。	核心	GA
az postgres flexible-server restore	从备份还原灵活服务器。	核心	GA
az postgres flexible-server revive-dropped	从备份中恢复已删除的灵活服务器。	核心	GA
az postgres flexible-server server-logs	管理 PostgreSQL 灵活服务器的服务器日志（日志文件）。	核心	GA
az postgres flexible-server server-logs download	下载 PostgreSQL 灵活服务器的日志文件。	核心	GA
az postgres flexible-server server-logs list	列出 PostgreSQL 灵活服务器的日志文件。	核心	GA
az postgres flexible-server show	获取灵活服务器的详细信息。	核心	GA
az postgres flexible-server show-connection-string	显示 PostgreSQL 灵活服务器数据库的连接字符串。	核心	GA
az postgres flexible-server start	启动灵活服务器。	核心	GA
az postgres flexible-server stop	停止灵活服务器。	核心	GA
az postgres flexible-server update	更新灵活服务器。	核心	GA
az postgres flexible-server upgrade	升级灵活服务器的主要版本。	核心	GA
az postgres flexible-server virtual-endpoint	管理 PostgreSQL 灵活服务器的虚拟终结点。	核心	GA
az postgres flexible-server virtual-endpoint create	为灵活服务器创建新的虚拟终结点。	核心	GA
az postgres flexible-server virtual-endpoint delete	删除虚拟终结点。	核心	GA
az postgres flexible-server virtual-endpoint list	列出灵活服务器的所有虚拟终结点。	核心	GA
az postgres flexible-server virtual-endpoint show	获取虚拟终结点的详细信息。	核心	GA
az postgres flexible-server virtual-endpoint update	更新虚拟终结点。	核心	GA
az postgres flexible-server wait	等待灵活服务器满足某些条件。	核心	GA
az postgres server	管理 PostgreSQL 服务器。	核心	GA
az postgres server-arc	管理已启用 Azure Arc 的 PostgreSQL 服务器。	扩展	预览
az postgres server-arc create	创建已启用 Azure Arc 的 PostgreSQL 服务器。	扩展	预览
az postgres server-arc delete	删除已启用 Azure Arc 的 PostgreSQL 服务器。	扩展	预览
az postgres server-arc endpoint	管理已启用 Azure Arc 的 PostgreSQL 服务器终结点。	扩展	预览
az postgres server-arc endpoint list	列出已启用 Azure Arc 的 PostgreSQL 服务器终结点。	扩展	预览
az postgres server-arc list	列出已启用 Azure Arc 的 PostgreSQL 服务器。	扩展	预览
az postgres server-arc restore	从另一台服务器的备份还原已启用 Azure Arc 的 PostgreSQL 服务器。	扩展	预览
az postgres server-arc show	显示已启用 Azure Arc 的 PostgreSQL 服务器的详细信息。	扩展	预览
az postgres server-arc update	更新已启用 Azure Arc 的 PostgreSQL 服务器的配置。	扩展	预览
az postgres server-logs	管理服务器日志。	核心	GA
az postgres server-logs download	下载日志文件。	核心	GA
az postgres server-logs list	列出服务器的日志文件。	核心	GA
az postgres server ad-admin	管理 postgres 服务器的 Active Directory 管理员。	核心	GA
az postgres server ad-admin create	为 PostgreSQL 服务器创建 Active Directory 管理员istrator。	核心	GA
az postgres server ad-admin delete	删除 PostgreSQL 服务器的 Active Directory 管理员istrator。	核心	GA
az postgres server ad-admin list	列出 PostgreSQL 服务器的所有 Active Directory 管理员istrators。	核心	GA
az postgres server ad-admin show	获取 PostgreSQL 服务器的 Active Directory 管理员istrator 信息。	核心	GA
az postgres server ad-admin wait	将 CLI 置于等待状态，直到满足 PostgreSQL 服务器 Active Directory 管理员istrator 的条件。	核心	GA
az postgres server configuration	管理服务器的配置值。	核心	GA
az postgres server configuration list	列出服务器的配置值。	核心	GA
az postgres server configuration set	更新服务器的配置。	核心	GA
az postgres server configuration show	获取服务器的配置。”	核心	GA
az postgres server create	创建服务器。	核心	GA
az postgres server delete	删除服务器。	核心	GA
az postgres server firewall-rule	管理服务器的防火墙规则。	核心	GA
az postgres server firewall-rule create	为服务器创建新的防火墙规则。	核心	GA
az postgres server firewall-rule delete	删除防火墙规则。	核心	GA
az postgres server firewall-rule list	列出服务器的所有防火墙规则。	核心	GA
az postgres server firewall-rule show	获取防火墙规则的详细信息。	核心	GA
az postgres server firewall-rule update	更新防火墙规则。	核心	GA
az postgres server georestore	从备份异地还原服务器。	核心	GA
az postgres server key	管理 PostgreSQL 服务器密钥。	核心	GA
az postgres server key create	创建服务器密钥。	核心	GA
az postgres server key delete	删除服务器密钥。	核心	GA
az postgres server key list	获取服务器密钥的列表。	核心	GA
az postgres server key show	显示服务器密钥。	核心	GA
az postgres server list	列出可用的服务器。	核心	GA
az postgres server list-skus	列出给定区域中的可用 SKU。	核心	GA
az postgres server private-endpoint-connection	管理 PostgreSQL 服务器专用终结点连接。	核心	GA
az postgres server private-endpoint-connection approve	批准与 PostgreSQL 服务器关联的指定专用终结点连接。	核心	GA
az postgres server private-endpoint-connection delete	删除与 PostgreSQL 服务器关联的指定专用终结点连接。	核心	GA
az postgres server private-endpoint-connection reject	拒绝与 PostgreSQL 服务器关联的指定专用终结点连接。	核心	GA
az postgres server private-endpoint-connection show	显示与 PostgreSQL 服务器关联的专用终结点连接的详细信息。	核心	GA
az postgres server private-link-resource	管理 PostgreSQL 服务器专用链接资源。	核心	GA
az postgres server private-link-resource list	列出 PostgreSQL 服务器支持的专用链接资源。	核心	GA
az postgres server replica	管理读取副本 (replica)。	核心	GA
az postgres server replica create	创建服务器的只读副本。	核心	GA
az postgres server replica list	列出某个给定服务器的所有只读副本。	核心	GA
az postgres server replica stop	停止复制到只读副本，并使该副本成为读/写服务器。	核心	GA
az postgres server restart	重启服务器。	核心	GA
az postgres server restore	从备份还原服务器。	核心	GA
az postgres server show	获取服务器的详细信息。	核心	GA
az postgres server show-connection-string	显示 PostgreSQL 服务器数据库的连接字符串。	核心	GA
az postgres server update	更新服务器。	核心	GA
az postgres server vnet-rule	管理服务器的虚拟网络规则。	核心	GA
az postgres server vnet-rule create	创建一个虚拟网络规则以允许访问 PostgreSQL 服务器。	核心	GA
az postgres server vnet-rule delete	删除具有给定名称的虚拟网络规则。	核心	GA
az postgres server vnet-rule list	获取服务器中的虚拟网络规则列表。	核心	GA
az postgres server vnet-rule show	获取虚拟网络规则。	核心	GA
az postgres server vnet-rule update	更新虚拟网络规则。	核心	GA
az postgres server wait	等待服务器满足某些条件。	核心	GA
az postgres show-connection-string	显示 PostgreSQL 服务器数据库的连接字符串。	扩展	GA
az postgres up	设置 Azure Database for PostgreSQL 服务器和配置。	扩展	GA

az postgres down

删除 PostgreSQL 服务器及其缓存的信息。

az postgres down [--delete-group]
                 [--no-wait]
                 [--resource-group]
                 [--server-name]
                 [--yes]

示例

从资源组中删除服务器和缓存的数据。

az postgres down

删除资源组和完整缓存。

az postgres down --delete-group

可选参数

--delete-group

删除该资源组。

--no-wait

不等待长时间运行的操作完成。

默认值: False

--resource-group -g

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

--server-name -s

服务器的名称。

--yes -y

不提示确认。

默认值: 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 获取完整的调试日志。

az postgres show-connection-string

显示 PostgreSQL 服务器数据库的连接字符串。

az postgres show-connection-string [--admin-password]
                                   [--admin-user]
                                   [--database-name]
                                   [--server-name]

可选参数

--admin-password -p

管理员的登录密码。

默认值: {password}

--admin-user -u

管理员的登录用户名。

默认值: {login}

--database-name -d

数据库的名称。

默认值: {database}

--server-name -s

服务器的名称。

默认值: {server}

全局参数

--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 postgres up

设置 Azure Database for PostgreSQL 服务器和配置。

az postgres up [--admin-password]
               [--admin-user]
               [--backup-retention]
               [--database-name]
               [--generate-password]
               [--geo-redundant-backup {Disabled, Enabled}]
               [--location]
               [--resource-group]
               [--server-name]
               [--sku-name]
               [--ssl-enforcement {Disabled, Enabled}]
               [--storage-size]
               [--tags]
               [--version]

示例

确保 Azure Database for PostgreSQL 服务器已启动并运行并配置为立即使用。

az postgres up

若要替代默认名称，请提供指示所需值/现有资源的参数。

az postgres up -g MyResourceGroup -s MyServer -d MyDatabase -u MyUsername -p MyPassword

可选参数

--admin-password -p

管理员的登录密码。 最少 8 个字符，最多 128 个字符。 密码必须包含以下三个类别中的字符：英语大写字母、英文小写字母、数字和非字母数字字符。密码不能包含登录名的全部或部分。 登录名的一部分定义为三个或多个连续字母数字字符。

--admin-user -u

管理员的登录用户名。

--backup-retention

备份保留的天数。

--database-name -d

要初始化的数据库的名称。

--generate-password

生成密码。

--geo-redundant-backup

为服务器备份启用异地冗余或不启用。

接受的值: Disabled, Enabled

默认值: Disabled

--location -l

位置。 az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。

--resource-group -g

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

--server-name -s

服务器的名称。

--sku-name

sku 的名称（通常为层 + 系列 + 核心），例如B_Gen4_1，GP_Gen5_8。

默认值: GP_Gen5_2

--ssl-enforcement

在连接到服务器时启用 ssl 强制。

接受的值: Disabled, Enabled

默认值: Enabled

--storage-size

服务器的最大存储大小。 单位为兆字节。

--tags

空格分隔标记：key[=value] [key[=value] ...]。使用“”清除现有标记。

--version

服务器版本。

默认值: 10

全局参数

--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 获取完整的调试日志。