New-SqlAvailabilityGroup
構文
ByPath (既定)
New-SqlAvailabilityGroup
[-Name] <String>
[[-Path] <String>]
-AvailabilityReplica <AvailabilityReplica[]>
[-Database <String[]>]
[-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
[-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
[-HealthCheckTimeout <Int32>]
[-BasicAvailabilityGroup]
[-DatabaseHealthTrigger]
[-DtcSupportEnabled]
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
New-SqlAvailabilityGroup
[-Name] <String>
[-InputObject] <Server>
-AvailabilityReplica <AvailabilityReplica[]>
[-Database <String[]>]
[-AutomatedBackupPreference <AvailabilityGroupAutomatedBackupPreference>]
[-FailureConditionLevel <AvailabilityGroupFailureConditionLevel>]
[-HealthCheckTimeout <Int32>]
[-BasicAvailabilityGroup]
[-DatabaseHealthTrigger]
[-DtcSupportEnabled]
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
New-SqlAvailabilityGroup コマンドレットは、AlwaysOn 可用性グループに可用性グループを作成します。
InputObject または Path パラメーターは、初期プライマリ レプリカをホストするサーバーを指定します。
例
例 1: 可用性グループを作成する
PS C:\> $PrimaryServer = Get-Item "SQLSERVER:\SQL\PrimaryServer\Instance22"
PS C:\> $SecondaryServer = Get-Item "SQLSERVER:\SQL\SecondaryServer\Instance22"
PS C:\> $PrimaryReplica = New-SqlAvailabilityReplica -Name "PrimaryServer\Instance22" -EndpointUrl "TCP://PrimaryServer.domain:5022" -FailoverMode "Automatic" -AvailabilityMode "SynchronousCommit" -AsTemplate -Version ($PrimaryServer.Version)
PS C:\> $SecondaryReplica = New-SqlAvailabilityReplica -Name "SecondaryServer\Instance22" -EndpointUrl "TCP://SecondaryServer.domain:5022" -FailoverMode "Automatic" -AvailabilityMode "SynchronousCommit" -AsTemplate -Version ($SecondaryServer.Version)
PS C:\> New-SqlAvailabilityGroup -InputObject $PrimaryServer -Name "MainAG" -AvailabilityReplica ($PrimaryReplica, $SecondaryReplica) -Database @("Database01","Database02")
最初のコマンドは、プライマリ サーバー上の SQL Server のインスタンスを取得し、$PrimaryServer変数に格納します。
2 番目のコマンドは、セカンダリ サーバー上の SQL Server のインスタンスを取得し、$SecondaryServer変数に格納します。
3 番目のコマンドは、 New-SqlAvailabilityReplica コマンドレットを使用してプライマリ サーバー インスタンスを含むレプリカを作成し、$PrimaryReplica変数に格納します。
このコマンドは、$PrimaryServerの Version プロパティを使用して、サーバー インスタンスの バージョン を指定します。
4 番目のコマンドは、 New-SqlAvailabilityReplica を使用してセカンダリ サーバー インスタンスを含むレプリカを作成し、$SecondaryReplica変数に格納します。
このコマンドは、$SecondaryServerの Version プロパティを使用して、サーバー インスタンスの バージョン を指定します。
最後のコマンドによって可用性グループが作成されます。
名前、プライマリ サーバー、レプリカ、およびその他の情報を指定します。
パラメーター
-AutomatedBackupPreference
可用性グループの自動バックアップ設定を指定します。
このパラメーターに使用できる値は次のとおりです。
- 原発。
バックアップが常にプライマリ レプリカで実行されることを指定します。
このオプションでは、差分バックアップなど、セカンダリ レプリカでバックアップを実行するときに使用できない機能の使用がサポートされます。
- SecondaryOnly。
プライマリ レプリカでバックアップが実行されないように指定します。
プライマリ レプリカがオンラインの唯一のレプリカである場合、バックアップは行われません。
- 付帯。
プライマリ レプリカが唯一のレプリカオンラインでない限り、セカンダリ レプリカでバックアップを実行することを指定します。
その後、プライマリ レプリカでバックアップが実行されます。
- なし。
バックアップを実行するレプリカを決定するときに、プライマリまたはセカンダリの状態が考慮されないことを指定します。
代わりに、バックアップの優先度とオンライン状態によって、バックアップを実行するレプリカが決まります。
パラメーターのプロパティ
| 型: | AvailabilityGroupAutomatedBackupPreference
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-AvailabilityReplica
このコマンドレットが可用性グループに含める可用性レプリカの配列を指定します。
AvailabilityReplica オブジェクトを取得するには、New-SqlAvailabilityReplica コマンドレットを使用します。
AsTemplate パラメーターを指定します。
パラメーターのプロパティ
| 型: | AvailabilityReplica[]
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-BasicAvailabilityGroup
New-SqlAvailabilityGroup コマンドレットは、AlwaysOn 可用性グループに可用性グループを作成します。
InputObject または Path パラメーターは、初期プライマリ レプリカをホストするサーバーを指定します。
パラメーターのプロパティ
| 型: | SwitchParameter
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
| 型: | SwitchParameter
|
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Database
ローカルの読み取り/書き込みユーザー データベースの配列を指定します。
これらのデータベースは完全復旧モデルを使用する必要があり、AUTO_CLOSEを使用してはなりません。
これらのデータベースは別の可用性グループに属できず、データベース ミラーリング用に構成することはできません。
このパラメーターには値を指定する必要があります。
パラメーターのプロパティ
| 型: | String[]
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DatabaseHealthTrigger
New-SqlAvailabilityGroup コマンドレットは、AlwaysOn 可用性グループに可用性グループを作成します。
InputObject または Path パラメーターは、初期プライマリ レプリカをホストするサーバーを指定します。
パラメーターのプロパティ
| 型: | SwitchParameter
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DtcSupportEnabled
New-SqlAvailabilityGroup コマンドレットは、AlwaysOn 可用性グループに可用性グループを作成します。
InputObject または Path パラメーターは、初期プライマリ レプリカをホストするサーバーを指定します。
パラメーターのプロパティ
| 型: | SwitchParameter
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-FailureConditionLevel
可用性グループの自動フェールオーバー動作を指定します。
このパラメーターに使用できる値は次のとおりです。
- OnServerDown。
SQL Server サービスが停止した場合は、フェールオーバーまたは再起動します。
- OnServerUnresponsive。
低い値の条件が満たされている場合、および SQL Server サービスがクラスターに接続されていて HealthCheckTimeout しきい値を超えた場合、または現在プライマリ ロールの可用性レプリカが失敗状態にある場合は、フェールオーバーまたは再起動します。
- OnCriticalServerError。
低い値の条件が満たされている場合、さらに、メモリ不足、重大な書き込みアクセス違反、またはダンプが多すぎる内部重大なサーバー エラーが発生した場合は、フェールオーバーまたは再起動します。
- OnModerateServerError。
低い値の条件が満たされている場合、および中程度のサーバー エラーが発生した場合はフェールオーバーまたは再起動します。これには、永続的なメモリ不足状態が含まれます。
- OnAnyQualifiedFailureConditions。
低い値の条件が満たされている場合はフェールオーバーまたは再起動します。さらに、エンジン ワーカー スレッドの枯渇や解決できないデッドロックの検出など、条件を満たすエラー状態が発生した場合は、フェールオーバーまたは再起動します。
パラメーターのプロパティ
| 型: | AvailabilityGroupFailureConditionLevel
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-HealthCheckTimeout
AlwaysOn 可用性グループが応答しないサーバーを異常と宣言するまでの時間をミリ秒単位で指定します。
パラメーターのプロパティ
| 型: | Int32
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
このコマンドレットによって作成される可用性グループのプライマリ レプリカをホストする SQL Server のインスタンスを指定します。
| 型: | Server
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
ByObject
| 配置: | 3 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
このコマンドレットによって作成される可用性グループの名前を指定します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 2 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Path
このコマンドレットによって作成される可用性グループの初期プライマリ レプリカをホストする SQL Server のインスタンスのパスを指定します。
このパラメーターを指定しない場合、このコマンドレットは現在の作業場所を使用します。
値を指定する場合、パスは現在存在している必要があります。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ByPath
| 配置: | 3 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Script
このコマンドレットは、このコマンドレットが実行するタスクを実行する Transact-SQL スクリプトを返します。
パラメーターのプロパティ
| 型: | SwitchParameter
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 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.Server
サーバー インスタンスをこのコマンドレットに渡すことができます。
出力
Microsoft.SqlServer.Management.Smo.AvailabilityGroup