Get-AzureSqlDatabaseCopy

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

Note

このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用する従来の Azure リソースを管理するためのものです。 ASM の提供終了が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、Azure Service Manager の提供終了に関するページを参照してください

Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するために推奨される 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 を表すオブジェクトを指定します。 このコマンドレットは、このパラメーターが指定するデータベースのコピー状態を取得します。

型:Database
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-DatabaseCopy

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

型:DatabaseCopy
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-DatabaseName

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PartnerDatabase

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PartnerServer

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Profile

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

型:AzureSMProfile
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ServerName

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

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

入力

Microsoft.WindowsAzure.Commands.SqlDatabase.Model.DatabaseCopy

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

出力

Microsoft.WindowsAzure.Commands.SqlDatabase.Model.DatabaseCopy

メモ

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