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

Test-AzPostgreSqlFlexibleServerConnect

测试与数据库服务器的连接

语法

Test (默认值)

Test-AzPostgreSqlFlexibleServerConnect
    -Name <String>
    -ResourceGroupName <String>
    -AdministratorLoginPassword <SecureString>
    [-DatabaseName <String>]
    [-Timeout <Int32>]
    [-AdministratorUserName <String>]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

TestAndQuery

Test-AzPostgreSqlFlexibleServerConnect
    -Name <String>
    -ResourceGroupName <String>
    -QueryText <String>
    -AdministratorLoginPassword <SecureString>
    [-DatabaseName <String>]
    [-Timeout <Int32>]
    [-AdministratorUserName <String>]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

TestViaIdentityAndQuery

Test-AzPostgreSqlFlexibleServerConnect
    -QueryText <String>
    -AdministratorLoginPassword <SecureString>
    -InputObject <IPostgreSqlIdentity>
    [-DatabaseName <String>]
    [-Timeout <Int32>]
    [-AdministratorUserName <String>]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

TestViaIdentity

Test-AzPostgreSqlFlexibleServerConnect
    -AdministratorLoginPassword <SecureString>
    -InputObject <IPostgreSqlIdentity>
    [-DatabaseName <String>]
    [-Timeout <Int32>]
    [-AdministratorUserName <String>]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

说明

测试与数据库服务器的连接

示例

示例 1:按名称测试连接

$password = ConvertTo-SecureString <YourPassword> -AsPlainText
Test-AzPostgreSqlFlexibleServerConnect -ResourceGroupName PowershellPostgreSqlTest -Name postgresql-test -AdministratorLoginPassword $password
The connection testing to postgresql-test.database.azure.com was successful!

按资源组和服务器名称测试连接

示例 2:按标识测试连接

$password = ConvertTo-SecureString <YourPassword> -AsPlainText
Get-AzPostgreSqlFlexibleServer -ResourceGroupName PowershellPostgreSqlTest -ServerName postgresql-test | Test-AzPostgreSqlFlexibleServerConnect -AdministratorLoginPassword $password
The connection testing to postgresql-test.database.azure.com was successful!

按标识测试连接

示例 3:按名称测试查询

$password = ConvertTo-SecureString <YourPassword> -AsPlainText
Test-AzPostgreSqlFlexibleServerConnect -ResourceGroupName PowershellPostgreSqlTest -Name postgresql-test -AdministratorLoginPassword $password -QueryText "SELECT * FROM test"
col
-----
1
2
3

按资源组和服务器名称测试查询

示例 4:按标识测试连接

Get-AzPostgreSqlFlexibleServer -ResourceGroupName PowershellPostgreSqlTest -ServerName postgresql-test | Test-AzPostgreSqlFlexibleServerConnect -QueryText "SELECT * FROM test" -AdministratorLoginPassword $password
col
-----
1
2
3

按标识测试查询

参数

-AdministratorLoginPassword

管理员的密码。 最少 8 个字符,最多 128 个字符。 密码必须包含以下三个类别中的字符:英语大写字母、英文小写字母、数字和非字母数字字符。

参数属性

类型:SecureString
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-AdministratorUserName

服务器的管理员用户名。 设置后,无法更改它。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DatabaseName

要连接的数据库名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

参数属性

类型:PSObject
默认值:None
支持通配符:False
不显示:False
别名:AzureRMContext, AzureCredential

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-InputObject

要连接的服务器。 若要构造,请参阅 INPUTOBJECT 属性的 NOTES 部分并创建哈希表。

参数属性

类型:IPostgreSqlIdentity
默认值:None
支持通配符:False
不显示:False

参数集

TestViaIdentityAndQuery
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False
TestViaIdentity
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Name

要连接的服务器的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:服务器名称

参数集

Test
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
TestAndQuery
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-QueryText

要测试的数据库的查询

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

TestAndQuery
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
TestViaIdentityAndQuery
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ResourceGroupName

包含资源的资源组的名称,可以从 Azure 资源管理器 API 或门户获取此值。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

Test
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
TestAndQuery
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Timeout

查询执行的超时(以秒为单位)。 有效范围为 1-31536000 秒。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

IPostgreSqlIdentity

输出

String