使用 PowerShell 自定义 Azure Database for PostgreSQL 服务器参数Customize Azure Database for PostgreSQL server parameters using PowerShell

可以使用 PowerShell 列出、显示和更新 Azure Database for PostgreSQL 服务器的配置参数。You can list, show, and update configuration parameters for an Azure Database for PostgreSQL server using PowerShell. 在服务器级别会公开引擎配置的一个子集,并可以进行修改。A subset of engine configurations is exposed at the server-level and can be modified.

先决条件Prerequisites

若要完成本操作指南,需要:To complete this how-to guide, you need:

重要

尽管 Az.PostgreSql PowerShell 模块为预览版,但必须使用以下命令从 Az PowerShell 模块单独安装它:Install-Module -Name Az.PostgreSql -AllowPrereleaseWhile the Az.PostgreSql PowerShell module is in preview, you must install it separately from the Az PowerShell module using the following command: Install-Module -Name Az.PostgreSql -AllowPrerelease.

使用 Connect-AzAccount cmdlet 连接到 Azure 帐户。Connect to your Azure account using the Connect-AzAccount cmdlet.

列出 Azure Database for PostgreSQL 服务器的服务器配置参数List server configuration parameters for Azure Database for PostgreSQL server

若要列出服务器中的所有可修改参数及其值,请运行 Get-AzPostgreSqlConfiguration cmdlet。To list all modifiable parameters in a server and their values, run the Get-AzPostgreSqlConfiguration cmdlet.

以下示例列出了资源组 myresourcegroup 中服务器 mydemoserver 的服务器配置参数。The following example lists the server configuration parameters for the server mydemoserver in resource group myresourcegroup.

Get-AzPostgreSqlConfiguration -ResourceGroupName myresourcegroup -ServerName mydemoserver

有关每个列出参数的定义,请参阅环境变量上的 PostgreSQL 引用部分。For the definition of each of the listed parameters, see the PostgreSQL reference section on Environment Variables.

显示服务器配置参数详细信息Show server configuration parameter details

若要显示有关服务器的特定配置参数的详细信息,请运行 Get-AzPostgreSqlConfiguration cmdlet 并指定 Name 参数。To show details about a particular configuration parameter for a server, run the Get-AzPostgreSqlConfiguration cmdlet and specify the Name parameter.

本示例显示了资源组“myresourcegroup”下服务器 mydemoserver 的服务器配置参数 slow_query_log 的详细信息。This example shows details of the slow_query_log server configuration parameter for server mydemoserver under resource group myresourcegroup.

Get-AzPostgreSqlConfiguration -Name slow_query_log -ResourceGroupName myresourcegroup -ServerName mydemoserver

修改服务器配置参数值Modify a server configuration parameter value

还可以修改某个服务器配置参数的值,这会更新 PostgreSQL 服务器引擎的基础配置值。You can also modify the value of a certain server configuration parameter, which updates the underlying configuration value for the PostgreSQL server engine. 若要更新配置,请使用 Update-AzPostgreSqlConfiguration cmdlet。To update the configuration, use the Update-AzPostgreSqlConfiguration cmdlet.

更新资源组“myresourcegroup”下服务器 mydemoserver 的服务器配置参数 slow_query_log。To update the slow_query_log server configuration parameter of server mydemoserver under resource group myresourcegroup.

Update-AzPostgreSqlConfiguration -Name slow_query_log -ResourceGroupName myresourcegroup -ServerName mydemoserver -Value On

后续步骤Next steps