New-SqlAvailabilityReplica

構文

New-SqlAvailabilityReplica
   -AvailabilityMode <AvailabilityReplicaAvailabilityMode>
   -FailoverMode <AvailabilityReplicaFailoverMode>
   -EndpointUrl <String>
   [-SessionTimeout <Int32>]
   [-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
   [-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
   [-BackupPriority <Int32>]
   [-ReadOnlyRoutingList <String[]>]
   [-ReadonlyRoutingConnectionUrl <String>]
   [-SeedingMode <AvailabilityReplicaSeedingMode>]
   [-LoadBalancedReadOnlyRoutingList <String[][]>]
   [-Name] <String>
   [[-Path] <String>]
   [-Script]
   [-AccessToken <PSObject>]
   [-TrustServerCertificate]
   [-HostNameInCertificate <String>]
   [-Encrypt <String>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-SqlAvailabilityReplica
   -AvailabilityMode <AvailabilityReplicaAvailabilityMode>
   -FailoverMode <AvailabilityReplicaFailoverMode>
   -EndpointUrl <String>
   [-SessionTimeout <Int32>]
   [-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
   [-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
   [-BackupPriority <Int32>]
   [-ReadOnlyRoutingList <String[]>]
   [-ReadonlyRoutingConnectionUrl <String>]
   [-SeedingMode <AvailabilityReplicaSeedingMode>]
   [-LoadBalancedReadOnlyRoutingList <String[][]>]
   [-AsTemplate]
   [-Version <ServerVersion>]
   [-Name] <String>
   [-Script]
   [-AccessToken <PSObject>]
   [-TrustServerCertificate]
   [-HostNameInCertificate <String>]
   [-Encrypt <String>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-SqlAvailabilityReplica
   -AvailabilityMode <AvailabilityReplicaAvailabilityMode>
   -FailoverMode <AvailabilityReplicaFailoverMode>
   -EndpointUrl <String>
   [-SessionTimeout <Int32>]
   [-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
   [-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
   [-BackupPriority <Int32>]
   [-ReadOnlyRoutingList <String[]>]
   [-ReadonlyRoutingConnectionUrl <String>]
   [-SeedingMode <AvailabilityReplicaSeedingMode>]
   [-LoadBalancedReadOnlyRoutingList <String[][]>]
   [-Name] <String>
   [-InputObject] <AvailabilityGroup>
   [-Script]
   [-AccessToken <PSObject>]
   [-TrustServerCertificate]
   [-HostNameInCertificate <String>]
   [-Encrypt <String>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

New-SqlAvailabilityReplica コマンドレットによって可用性レプリカが作成されます。 プライマリ レプリカをホストする SQL Server のインスタンスでこのコマンドレットを実行します。

可用性グループを作成する前に可用性レプリカを作成するには、AsTemplate パラメーターを指定します。 既存の可用性グループにレプリカを追加するには、InputObject または Path パラメーターで可用性グループを指定します。

例

例 1: 可用性レプリカの表現を作成する

PS C:\> $ServerObject = Get-Item "SQLSERVER:\Sql\PrimaryServer\InstanceName"
PS C:\> New-SqlAvailabilityReplica -Name "PrimaryServer\Instance" -EndpointUrl "TCP://PrimaryServerName.domain.com:5022" -FailoverMode Automatic -AvailabilityMode SynchronousCommit -AsTemplate -Version $ServerObject.Version

この例では、可用性レプリカのメモリ内表現を作成します。 変更はサーバーにコミットされません。 このレプリカは、New-SqlAvailabilityGroup の AvailabilityReplica パラメーター 値として使用できます。

最初のコマンドは、プライマリ サーバーのインスタンスを取得します。

2 番目のコマンドは、可用性レプリカを作成します。 このレプリカは、指定された URL にあるデータベース ミラーリング エンドポイントを使用して、可用性グループ内の他のレプリカと通信します。 このレプリカでは、自動フェールオーバーと同期コミット可用性モードがサポートされます。 Version パラメーターは、この新しいレプリカをホストするサーバー インスタンスのバージョンを指定します。

例 2: 手動フェールオーバーと非同期コミットをサポートする可用性レプリカを作成する

PS C:\> $ServerObject = Get-Item "SQLSERVER:\Sql\PrimaryServer\InstanceName"
PS C:\> New-SqlAvailabilityReplica -Name "SecondaryServer\Instance" -EndpointUrl "TCP://PrimaryServerName.domain.com:5022" -FailoverMode Manual -AvailabilityMode AsynchronousCommit -AsTemplate -Version $ServerObject.Version

この例では、可用性レプリカのメモリ内表現を作成します。 変更はサーバーにコミットされません。

最初のコマンドは、プライマリ サーバーのインスタンスを取得します。

2 番目のコマンドは、可用性レプリカを作成します。 このレプリカは、指定された URL にあるデータベース ミラーリング エンドポイントを使用して、可用性グループ内の他のレプリカと通信します。 このレプリカでは、手動フェールオーバーと非同期コミット可用性モードがサポートされます。 Version パラメーターは、この新しいレプリカをホストするサーバー インスタンスのバージョンを指定します。

例 3: 可用性グループに可用性レプリカを追加する

PS C:\> New-SqlAvailabilityReplica -Name "SecondaryServer\Instance" -EndpointUrl "TCP://PrimaryServerName.domain.com:5022" -FailoverMode Manual -AvailabilityMode AsynchronousCommit -ConnectionModeInSecondaryRole AllowAllConnections -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG"

このコマンドは、'MainAG' という名前の既存の可用性グループに可用性レプリカを追加します。 このレプリカでは、手動フェールオーバーと非同期コミット可用性モードがサポートされます。 セカンダリ ロールでは、このレプリカは読み取りアクセス接続をサポートします。 この構成により、読み取り専用処理をこのレプリカにオフロードできます。

パラメーター

-AccessToken

-AsTemplate

-AvailabilityMode

-BackupPriority

-Confirm

-ConnectionModeInPrimaryRole

-ConnectionModeInSecondaryRole

-Encrypt

-EndpointUrl

-FailoverMode

-HostNameInCertificate

-InputObject

-LoadBalancedReadOnlyRoutingList

-Name

-Path

-ProgressAction

-ReadonlyRoutingConnectionUrl

-ReadOnlyRoutingList

-Script

-SeedingMode

-SessionTimeout

-TrustServerCertificate

-Version

-WhatIf

入力

Microsoft.SqlServer.Management.Smo.AvailabilityGroup

可用性グループをこのコマンドレットに渡すことができます。

出力

Microsoft.SqlServer.Management.Smo.AvailabilityReplica

このコマンドレットは可用性レプリカを返します。

関連リンク

• New-SqlAvailabilityGroup
• Remove-SqlAvailabilityReplica
• Set-SqlAvailabilityReplica
• Test-SqlAvailabilityReplica