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 コマンドレットを参照してください。