New-SqlAvailabilityReplica
可用性レプリカを作成します。
構文
ByPath (既定)
New-SqlAvailabilityReplica
[-Name] <String>
[[-Path] <String>]
-AvailabilityMode <AvailabilityReplicaAvailabilityMode>
-FailoverMode <AvailabilityReplicaFailoverMode>
-EndpointUrl <String>
[-SessionTimeout <Int32>]
[-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
[-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
[-BackupPriority <Int32>]
[-ReadOnlyRoutingList <String[]>]
[-ReadonlyRoutingConnectionUrl <String>]
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
AsTemplate
New-SqlAvailabilityReplica
[-Name] <String>
-AvailabilityMode <AvailabilityReplicaAvailabilityMode>
-FailoverMode <AvailabilityReplicaFailoverMode>
-EndpointUrl <String>
[-SessionTimeout <Int32>]
[-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
[-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
[-BackupPriority <Int32>]
[-ReadOnlyRoutingList <String[]>]
[-ReadonlyRoutingConnectionUrl <String>]
[-AsTemplate]
[-Version <ServerVersion>]
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
New-SqlAvailabilityReplica
[-Name] <String>
[-InputObject] <AvailabilityGroup>
-AvailabilityMode <AvailabilityReplicaAvailabilityMode>
-FailoverMode <AvailabilityReplicaFailoverMode>
-EndpointUrl <String>
[-SessionTimeout <Int32>]
[-ConnectionModeInPrimaryRole <AvailabilityReplicaConnectionModeInPrimaryRole>]
[-ConnectionModeInSecondaryRole <AvailabilityReplicaConnectionModeInSecondaryRole>]
[-BackupPriority <Int32>]
[-ReadOnlyRoutingList <String[]>]
[-ReadonlyRoutingConnectionUrl <String>]
[-Script]
[-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 という名前の既存の可用性グループに可用性レプリカを追加します。 このレプリカは、手動フェールオーバーと非同期コミット可用性モードをサポートします。 セカンダリ ロールでは、このレプリカは読み取りアクセス接続をサポートします。 この構成により、読み取り専用処理をこのレプリカにオフロードできます。
パラメーター
-AsTemplate
このコマンドレットが一時的な AvailabilityReplica オブジェクトをメモリ内に作成することを示します。 可用性レプリカを作成する前に可用性グループを作成するには、このパラメーターを指定します。 New-SqlAvailabilityGroup コマンドレットを使用して可用性グループを作成します。 AvailabilityReplica パラメーターの値として、一時的な可用性レプリカを指定します。
AsTemplate を指定した場合、このコマンドレットは InputObject パラメーターと Path パラメーターの値を無視します。
このパラメーターを指定する場合は、 Version パラメーターに SQL Server バージョンも指定する必要があります。または、現在のセッションでインスタンスへのアクティブな接続が必要です。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
AsTemplate
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-AvailabilityMode
レプリカ可用性モードを指定します。 このパラメーターに使用できる値は次のとおりです。
- SynchronousCommit
- AsynchronousCommit
$Nullの値を指定できます。
パラメーターのプロパティ
| 型: | AvailabilityReplicaAvailabilityMode |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-BackupPriority
バックアップを実行する際のレプリカの必要な優先順位を指定します。 このパラメーターに使用できる値は、0 から 100 までの整数です。 オンラインで使用可能なレプリカのセットのうち、優先度が最も高いレプリカがバックアップを実行します。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ConnectionModeInPrimaryRole
プライマリ ロールで可用性レプリカが接続を処理する方法を指定します。 このパラメーターに使用できる値は次のとおりです。
- AllowReadWriteConnections。 読み取り/書き込み接続を許可する
- AllowAllConnections。 すべての接続を許可する
パラメーターのプロパティ
| 型: | AvailabilityReplicaConnectionModeInPrimaryRole |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ConnectionModeInSecondaryRole
セカンダリ ロールで可用性レプリカが接続を処理する方法を指定します。 このパラメーターに使用できる値は次のとおりです。
- AllowNoConnections。 接続を許可しない
- AllowReadIntentConnectionsOnly。 読み取りインテント接続のみを許可する
- AllowAllConnections。 すべての接続を許可します
パラメーターのプロパティ
| 型: | AvailabilityReplicaConnectionModeInSecondaryRole |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-EndpointUrl
データベース ミラーリング エンドポイントの URL を指定します。 この URL は、次の形式の TCP アドレスです。
TCP://system-address:port
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-FailoverMode
フェールオーバー モードを指定します。 このパラメーターに使用できる値は次のとおりです。
- 自動
- 手動 $Nullの値を指定できます。
パラメーターのプロパティ
| 型: | AvailabilityReplicaFailoverMode |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-InputObject
可用性グループを、レプリカが属する AvailabilityGroup オブジェクトとして指定します。
パラメーターのプロパティ
| 型: | AvailabilityGroup |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ByObject
| 配置: | 3 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
可用性レプリカの名前を次の形式で指定します。
Computer\Instance
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 2 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Path
レプリカが属する可用性グループのパスを指定します。 このパラメーターを指定しない場合、このコマンドレットは現在の作業場所を使用します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ByPath
| 配置: | 3 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ReadonlyRoutingConnectionUrl
次の例のように、読み取り専用接続のためにレプリカにルーティングするときに使用する完全修飾ドメイン名 (FQDN) とポートを指定します。
TCP://DBSERVER8.manufacturing.Contoso.com:7024
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ReadOnlyRoutingList
この可用性レプリカを介して読み取り専用接続をリダイレクトするときに使用する接続ディレクターのプローブ シーケンスを表すレプリカ サーバー名の順序付きリストを指定します。 このパラメーターは、可用性レプリカが可用性グループの現在のプライマリ レプリカである場合に適用されます。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Script
このコマンドレットは、このコマンドレットが実行するタスクを実行する Transact-SQL スクリプトを返します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SessionTimeout
接続が失敗するまでのプライマリ レプリカとこのレプリカの間の応答を待機する時間を秒単位で指定します。
パラメーターのプロパティ
| 型: | Int32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Version
SQL Server のバージョンを指定します。 AsTemplate パラメーターを指定する場合は、バージョンを指定する必要があります。 テンプレート オブジェクトは、このバージョンを含むサーバー上のデザイン モードで作成されます。 次の例のように、整数または文字列を指定できます。
- 13
- "13.0.0"
パラメーターのプロパティ
| 型: | ServerVersion |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
AsTemplate
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
入力
Microsoft.SqlServer.Management.Smo.AvailabilityGroup
可用性グループをこのコマンドレットに渡すことができます。
出力
Microsoft.SqlServer.Management.Smo.AvailabilityReplica
このコマンドレットは可用性レプリカを返します。