Start-AzureSqlDatabaseCopy

モジュール:

Azure

Azure SQL Database のコピー操作を開始します。

注意

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

構文

Start-AzureSqlDatabaseCopy
     -ServerName <String>
     -Database <Database>
     [-PartnerServer <String>]
     -PartnerDatabase <String>
     [-Force]
     [-Profile <AzureSMProfile>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzureSqlDatabaseCopy
     -ServerName <String>
     -Database <Database>
     -PartnerServer <String>
     [-PartnerDatabase <String>]
     [-ContinuousCopy]
     [-OfflineSecondary]
     [-Force]
     [-Profile <AzureSMProfile>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzureSqlDatabaseCopy
     -ServerName <String>
     -DatabaseName <String>
     [-PartnerServer <String>]
     -PartnerDatabase <String>
     [-Force]
     [-Profile <AzureSMProfile>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzureSqlDatabaseCopy
     -ServerName <String>
     -DatabaseName <String>
     -PartnerServer <String>
     [-PartnerDatabase <String>]
     [-ContinuousCopy]
     [-OfflineSecondary]
     [-Force]
     [-Profile <AzureSMProfile>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

説明

Start-AzureSqlDatabaseCopy コマンドレットは、特定の Azure SQL Database の 1 回限りのコピー操作または連続コピー操作を開始します。 このコマンドレットはトランザクションではありません。

元のデータベースはソース データベースです。 コピーはセカンダリ データベースまたはターゲット データベースです。 連続コピーの場合、ソース データベースとターゲット データベースを同じサーバーに配置することはできません。また、ソース データベースとターゲット データベースをホストするサーバーは、同じサブスクリプションの一部である必要があります。

ContinuousCopy パラメーターを指定しない場合、このコマンドレットはソース データベースの 1 回限りのコピーを作成します。 応答を受信しても、操作は進行中です。 操作は、Get-AzureSqlDatabaseCopy または Get-AzureSqlDatabaseOperation コマンドレットを使用して監視できます。

ContinuousCopy を指定すると、このコマンドレットによってソース データベースの連続コピーが作成されます。 応答を受信すると、操作が進行中になります。 操作を監視するには、Get-AzureSqlDatabaseCopy または Get-AzureSqlDatabaseOperation を使用します。

連続コピーは、オンラインまたはオフラインのデータベースとして作成できます。 オンラインの連続コピーを使用して、Azure SQL Database のアクティブ geo レプリケーションを構成しますhttps://azure.microsoft.com/en-us/documentation/articles/sql-database-geo-replication-overview/. オフラインの連続コピーは、Azure SQL Database の Standard Geo レプリケーションを構成するために使用されますhttps://azure.microsoft.com/en-us/documentation/articles/sql-database-business-continuity-scenarios/.

例

例 1: 継続的なデータベース コピーをスケジュールする

PS C:\> Start-AzureSqlDatabaseCopy -ServerName "lpqd0zbr8y" -DatabaseName "Orders" -PartnerServer "bk0b8kf65" -ContinuousCopy

このコマンドは、lpqd0zbr8y という名前のサーバー上の Orders という名前のデータベースの連続コピーをスケジュールします。 このコマンドは、bk0b8kf658 という名前のサーバー上にターゲット データベースを作成します。

例 2: 同じサーバーに 1 回限りのコピーを作成する

PS C:\> Start-AzureSqlDatabaseCopy -ServerName "lpqd0zbr8y" -DatabaseName "Orders" -PartnerDatabase "OrdersCopy"

このコマンドは、lpqd0zbr8y という名前のサーバー上に Orders という名前のデータベースの 1 回限りのコピーを作成します。 このコマンドは、OrdersCopy という名前のコピーを同じサーバーに作成します。

例 3: 継続的なオフライン データベース コピーをスケジュールする

PS C:\> Start-AzureSqlDatabaseCopy -ServerName "lpqd0zbr8y" -DatabaseName "Orders" -PartnerServer "bk0b8kf65" -ContinuousCopy -OfflineSecondary

このコマンドは、lpqd0zbr8y という名前のサーバー上の Orders という名前のデータベースの連続コピーをスケジュールします。 このコマンドは、bk0b8kf658 という名前のサーバーにオフライン ターゲット データベースを作成します。

パラメーター

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ContinuousCopy

データベース のコピーが連続コピー (レプリカ データベース) であることを示します。 連続コピーは、同じサーバー内ではサポートされていません。 このパラメーターが指定されていない場合は、1 回限りコピーが実行されます。 1 回限りのコピーの場合、ソース データベースとパートナー データベースは同じサーバー上にある必要があります。

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

-Database

ソースの Azure SQL Database を表すオブジェクトを指定します。 このパラメーターは、パイプライン入力を受け入れます。

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

-DatabaseName

ソース データベースの名前を指定します。

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

-Force

ユーザーに確認せずに、直ちにコマンドを実行します。

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

-OfflineSecondary

連続コピーがアクティブ コピーではなくパッシブ コピーであることを指定します。 ソース データベースが Standard Edition データベースの場合、このパラメーターは必須です。 このパラメーターを指定する場合は、 ContinuousCopy も指定する必要があります。

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

-PartnerDatabase

ターゲット データベースの名前を指定します。 ContinuousCopy パラメーターを指定する場合、PartnerDatabase の値はソース データベースの名前と一致する必要があります。 ContinuousCopy を指定しない場合は、ターゲット データベースの名前を指定する必要があります。ソース データベース名とは異なる場合があります。

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

-PartnerServer

ターゲット データベースをホストするサーバーの名前を指定します。 このサーバーは、ソース データベース サーバーと同じ Azure サブスクリプション内にある必要があります。

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

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

入力

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

出力

Microsoft.WindowsAzure.Commands.SqlDatabase.Model.DatabaseCopy

メモ

• 認証: このコマンドレットには、証明書ベースの認証が必要です。 証明書ベースの認証を使用して現在のサブスクリプションを設定する方法の例については、「New-AzureSqlDatabaseServerContext コマンドレット」を参照してください。
• 監視: サーバー上でアクティブな 1 つ以上の連続コピー リレーションシップの状態を確認するには、Get-AzureSqlDatabaseCopy コマンドレットを使用します。 連続コピー関係のソースとターゲットの両方で操作の状態を確認するには、Get-AzureSqlDatabaseOperation コマンドレットを使用します。

関連リンク

• Azure SQL データベース
• Azure SQL データベースの操作
• データベース コピーの開始
• Get-AzureSqlDatabaseCopy
• Stop-AzureSqlDatabaseCopy