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

Get-AzureSqlDatabaseCopy

检查复制关系的状态。

注意

本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧 Azure 资源。 创建新的资源时,不建议使用此旧版 PowerShell 模块,因为 ASM 计划停用。 有关详细信息,请参阅 Azure Service Manager 停用

Az PowerShell 模块是推荐的 PowerShell 模块,用于使用 PowerShell 管理 Azure 资源管理器 (ARM) 资源。

语法

Get-AzureSqlDatabaseCopy
   -ServerName <String>
   [-DatabaseName <String>]
   [-PartnerServer <String>]
   [-PartnerDatabase <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Get-AzureSqlDatabaseCopy
   -ServerName <String>
   -DatabaseCopy <DatabaseCopy>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
Get-AzureSqlDatabaseCopy
   -ServerName <String>
   -Database <Database>
   [-PartnerServer <String>]
   [-PartnerDatabase <String>]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

说明

Get-AzureSqlDatabaseCopy cmdlet 检查一个或多个活动复制关系的状态。 运行 Start-AzureSqlDatabaseCopy 或 Stop-AzureSqlDatabaseCopy cmdlet 后运行此 cmdlet。 可以检查特定的复制关系、所有复制关系或复制关系的筛选列表,例如特定目标服务器上的所有副本。 可以在承载源数据库或目标数据库的服务器上运行此 cmdlet。

此 cmdlet 是同步的。 该 cmdlet 会阻止 Azure PowerShell 控制台,直到返回状态对象。

PartnerServerPartnerDatabase 参数是可选的。 如果未指定任一参数,此 cmdlet 将返回结果表。 若要查看仅特定数据库的状态,请指定这两个参数。

示例

示例 1:获取数据库的副本状态

PS C:\> Get-AzureSqlDatabaseCopy -ServerName "lpqd0zbr8y" -DatabaseName "Orders" -PartnerServer "bk0b8kf658"

此命令获取名为 lpqd0zbr8y 的服务器中名为 Orders 的数据库的状态。 PartnerServer 参数将此命令限制为 bk0b8kf658 服务器。

示例 2:获取服务器上的所有副本的状态:获取服务器上的所有副本的状态

PS C:\> Get-AzureSqlDatabaseCopy -ServerName "lpqd0zbr8y"

此命令获取名为 lpqd0zbr8y 的服务器上所有活动副本的状态。

参数

-Database

指定表示源Azure SQL 数据库的对象。 此 cmdlet 获取此参数指定的数据库的副本状态。

类型:Database
Position:Named
默认值:None
必需:True
Accept pipeline input:True
Accept wildcard characters:False

-DatabaseCopy

指定表示数据库的对象。 此 cmdlet 获取此参数指定的数据库的副本状态。 此参数接受管道输入。

类型:DatabaseCopy
Position:Named
默认值:None
必需:True
Accept pipeline input:True
Accept wildcard characters:False

-DatabaseName

指定源数据库的名称。 此 cmdlet 获取此参数指定的数据库的副本状态。

类型:String
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-PartnerDatabase

指定辅助数据库的名称。 如果在sys.dm_database_copies动态管理视图中找不到此数据库,则此 cmdlet 将返回空状态对象。

类型:String
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-PartnerServer

指定承载目标数据库的服务器的名称。 如果在sys.dm_database_copies动态管理视图中找不到此服务器,则此 cmdlet 将返回空状态对象。

类型:String
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件,此 cmdlet 将从本地默认配置文件中读取。

类型:AzureSMProfile
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-ServerName

指定数据库副本所在的服务器的名称。

类型:String
Position:Named
默认值:None
必需:True
Accept pipeline input:True
Accept wildcard characters:False

输入

Microsoft.WindowsAzure.Commands.SqlDatabase.Model.DatabaseCopy

Microsoft.WindowsAzure.Commands.SqlDatabase.Services.Server.Database

输出

Microsoft.WindowsAzure.Commands.SqlDatabase.Model.DatabaseCopy

备注

  • 身份验证:此 cmdlet 需要基于证书的身份验证。 有关如何使用基于证书的身份验证设置当前订阅的示例,请参阅 New-AzureSqlDatabaseServerContext cmdlet。