New-AzSqlDatabaseSecondary

モジュール:

Az.Sql

既存のデータベースのセカンダリ データベースを作成し、データ レプリケーションを開始します。

構文

New-AzSqlDatabaseSecondary
   [-DatabaseName] <String>
   [-SecondaryServiceObjectiveName <String>]
   [-SecondaryElasticPoolName <String>]
   [-Tags <Hashtable>]
   -PartnerResourceGroupName <String>
   -PartnerServerName <String>
   [-PartnerDatabaseName <String>]
   [-AllowConnections <AllowConnections>]
   [-AsJob]
   [-LicenseType <String>]
   [-BackupStorageRedundancy <String>]
   [-SecondaryType <String>]
   [-HighAvailabilityReplicaCount <Int32>]
   [-ZoneRedundant]
   [-AssignIdentity]
   [-EncryptionProtector <String>]
   [-UserAssignedIdentityId <String[]>]
   [-KeyList <String[]>]
   [-FederatedClientId <Guid>]
   [-EncryptionProtectorAutoRotation]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzSqlDatabaseSecondary
   [-DatabaseName] <String>
   [-Tags <Hashtable>]
   -PartnerResourceGroupName <String>
   -PartnerServerName <String>
   [-PartnerDatabaseName <String>]
   [-AllowConnections <AllowConnections>]
   [-AsJob]
   -SecondaryComputeGeneration <String>
   -SecondaryVCore <Int32>
   [-SecondaryComputeModel <String>]
   [-LicenseType <String>]
   [-AutoPauseDelayInMinutes <Int32>]
   [-MinimumCapacity <Double>]
   [-BackupStorageRedundancy <String>]
   [-SecondaryType <String>]
   [-HighAvailabilityReplicaCount <Int32>]
   [-ZoneRedundant]
   [-AssignIdentity]
   [-EncryptionProtector <String>]
   [-UserAssignedIdentityId <String[]>]
   [-KeyList <String[]>]
   [-FederatedClientId <Guid>]
   [-EncryptionProtectorAutoRotation]
   [-ServerName] <String>
   [-ResourceGroupName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

New-AzSqlDatabaseSecondary コマンドレットは、データベースの geo レプリケーションの設定に使用する場合、Start-AzSqlDatabaseCopy コマンドレットに置き換えます。 プライマリ データベースからセカンダリ データベースへの geo レプリケーション リンク オブジェクトが返されます。

例

例 1: アクティブ geo レプリケーションを確立する

$database = Get-AzSqlDatabase -DatabaseName $databasename -ResourceGroupName $primaryresourcegroupname -ServerName $primaryservername
$database | New-AzSqlDatabaseSecondary -PartnerResourceGroupName $secondaryresourcegroupname -PartnerServerName $secondaryservername -AllowConnections "All"

例 2: アクティブ geo レプリケーションを確立し、ソース データベース名と異なるパートナー データベース名を指定する

$database = Get-AzSqlDatabase -DatabaseName $databasename -ResourceGroupName $primaryresourcegroupname -ServerName $primaryservername
$database | New-AzSqlDatabaseSecondary -PartnerResourceGroupName $secondaryresourcegroupname -PartnerServerName $secondaryservername -PartnerDatabaseName $secondarydatabasename -AllowConnections "All"

パラメーター

-AllowConnections

セカンダリ Azure SQL Database の読み取り意図を指定します。 このパラメーターの有効値は、次のとおりです。

• いいえ
• すべて

型:	AllowConnections
指定可能な値:	No, All
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AsJob

バックグラウンドでコマンドレットを実行する

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

-AssignIdentity

Azure KeyVault などのキー管理サービスで使用するために、このデータベースの Microsoft Entra ID を生成して割り当てます。

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

-AutoPauseDelayInMinutes

データベースの自動一時停止遅延 (サーバーレスのみ)、-1 でオプトアウト

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

-BackupStorageRedundancy

SQL Database のバックアップを格納するために使用されるバックアップ ストレージの冗長性。 オプションは[ローカル]、[ゾーン]、[Geo]です。

型:	String
指定可能な値:	Local, Zone, Geo, GeoZone
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

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

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

-DatabaseName

プライマリとして機能するデータベースの名前を指定します。

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

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション

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

-EncryptionProtector

SQL Database コピーの暗号化保護機能キー。

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

-EncryptionProtectorAutoRotation

AKV キーの自動ローテーションの状態

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

-FederatedClientId

SQL Database のフェデレーション クライアント ID。 これは、テナント間の CMK シナリオに使用されます。

型:	Nullable<T>[Guid]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-HighAvailabilityReplicaCount

読み取りonly アプリケーションインテント接続のルーティング先となるデータベースに関連付けられている読み取りオンセカンダリ レプリカの数。 このプロパティは、Hyperscale Edition データベースに対してのみ設定できます。

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

-KeyList

SQL Database コピーの AKV キーの一覧。

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

-LicenseType

Azure Sql データベースのライセンスの種類。

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

-MinimumCapacity

セカンダリ データベースが常に割り当てる最小容量 (一時停止されていない場合)。 サーバーレス Azure Sql データベースの場合のみ。

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

-PartnerDatabaseName

作成するセカンダリ データベースの名前。

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

-PartnerResourceGroupName

このコマンドレットでセカンダリ データベースを割り当てる Azure リソース グループの名前を指定します。

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

-PartnerServerName

セカンダリとして機能する Azure SQL データベース サーバーの名前を指定します。

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

-ResourceGroupName

このコマンドレットでプライマリ データベースを割り当てる Azure リソース グループの名前を指定します。

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

-SecondaryComputeGeneration

Azure Sql Database セカンダリのコンピューティング世代。

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

-SecondaryComputeModel

Azure Sql Database セカンダリのコンピューティング モデル。 サーバーレスまたはプロビジョニング済み

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

-SecondaryElasticPoolName

セカンダリ データベースを配置するエラスティック プールの名前を指定します。

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

-SecondaryServiceObjectiveName

セカンダリ データベースに割り当てるサービス目標の名前を指定します。

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

-SecondaryType

データベースがセカンダリの場合は、そのセカンダリ の種類。 有効な値は Geo、Named、Standby です。

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

-SecondaryVCore

Azure Sql Database セカンダリの仮想コア番号。

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

-ServerName

プライマリ SQL Database の SQL Server の名前を指定します。

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

-Tags

SQL Database レプリケーション リンクに関連付けるハッシュ テーブルの形式でキーと値のペアを指定します。 例: @{key0="value0";key1=$null;key2="value2"}

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

-UserAssignedIdentityId

SQL Database コピーのユーザー割り当て ID の一覧。

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

-WhatIf

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

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

-ZoneRedundant

Azure Sql Database に関連付けるゾーンの冗長性。 このプロパティは、Hyperscale Edition データベースに対してのみ設定できます。

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

入力

String

出力

AzureReplicationLinkModel

関連リンク

• Remove-AzSqlDatabaseSecondary
• Set-AzSqlDatabaseSecondary
• SQL Database のドキュメント