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