Share via


Get-AzureSqlDatabaseCopy

コピー リレーションシップの状態を確認します。

注意

このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az PowerShell モジュールを参照してください。

構文

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 コマンドレットは、1 つ以上のアクティブなコピー リレーションシップの状態を確認します。 Start-AzureSqlDatabaseCopy または Stop-AzureSqlDatabaseCopy コマンドレットを実行した後、このコマンドレットを実行します。 特定のコピー リレーションシップ、すべてのコピー リレーションシップ、またはコピー リレーションシップのフィルター処理された一覧 (特定のターゲット サーバー上のすべてのコピーなど) を確認できます。 このコマンドレットは、ソース データベースまたはターゲット データベースをホストするサーバーで実行できます。

このコマンドレットは同期的です。 このコマンドレットは、状態オブジェクトが返されるまで Azure PowerShell コンソールをブロックします。

PartnerServer パラメーターと PartnerDatabase パラメーターは省略可能です。 どちらのパラメーターも指定しない場合、このコマンドレットは結果のテーブルを返します。 特定のデータベースのみの状態を表示するには、両方のパラメーターを指定します。

例 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 Database を表すオブジェクトを指定します。 このコマンドレットは、このパラメーターが指定するデータベースのコピー状態を取得します。

Type:Database
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DatabaseCopy

データベースを表すオブジェクトを指定します。 このコマンドレットは、このパラメーターが指定するデータベースのコピー状態を取得します。 このパラメーターは、パイプライン入力を受け入れます。

Type:DatabaseCopy
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DatabaseName

ソース データベースの名前を指定します。 このコマンドレットは、このパラメーターが指定するデータベースのコピー状態を取得します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PartnerDatabase

セカンダリ データベースの名前を指定します。 このデータベースが sys.dm_database_copies 動的管理ビューに見つからない場合、このコマンドレットは空の状態オブジェクトを返します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PartnerServer

ターゲット データベースをホストするサーバーの名前を指定します。 このサーバーがsys.dm_database_copies動的管理ビューに見つからない場合、このコマンドレットは空の状態オブジェクトを返します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServerName

データベース コピーが存在するサーバーの名前を指定します。

Type:String
Position:Named
Default value:None
Required: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

メモ

  • 認証: このコマンドレットには、証明書ベースの認証が必要です。 証明書ベースの認証を使用して現在のサブスクリプションを設定する方法の例については、New-AzureSqlDatabaseServerContext コマンドレットを参照してください。