Remove-SqlAvailabilityDatabase
可用性グループから可用性データベースを削除します。
構文
ByPath (既定)
Remove-SqlAvailabilityDatabase
[-Path] <String[]>
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Remove-SqlAvailabilityDatabase
[-InputObject] <AvailabilityDatabase[]>
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Remove-SqlAvailabilityDatabase コマンドレットは、可用性グループから可用性データベースを削除します。 InputObject または Path パラメーターは、可用性データベースを指定します。
プライマリ レプリカをホストするサーバー インスタンスでこのコマンドレットを実行すると、プライマリ データベースとそれに対応するすべてのセカンダリ データベースが可用性グループから削除されます。
セカンダリ レプリカをホストするサーバー インスタンスでこのコマンドレットを実行すると、コマンドレットはローカル セカンダリ データベースのみを可用性グループから削除します。 セカンダリ データベースは可用性グループに参加しなくなりましたが、データベースの他のコピーは引き続き結合されます。
例
例 1: 可用性グループからデータベースを削除する
PS C:\> Remove-SqlAvailabilityDatabase -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityDatabases\Database16"
このコマンドは、MainAG という名前の可用性グループから Database16 という名前の可用性データベースを削除します。 このコマンドは、プライマリ レプリカをホストするサーバー インスタンスで実行されます。 そのため、プライマリ データベースとそれに対応するすべてのセカンダリ データベースが可用性グループから削除されます。 セカンダリ レプリカでこのデータベースのデータ同期が行われなくなりました。
例 2: 可用性グループからすべてのデータベースを削除する
PS C:\> Get-ChildItem "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityDatabases" | Remove-SqlAvailabilityDatabase
このコマンドは、MainAG に属するすべての可用性データベースを取得し、パイプライン 演算子を使用して現在のコマンドレットに渡します。 現在のコマンドレットは、各可用性データベースを削除します。
例 3: 可用性グループからセカンダリ データベースを削除する
PS C:\> Remove-SqlAvailabilityDatabase -Path "SQLSERVER:\Sql\SecondaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityDatabases\Database16"
このコマンドは、Database16 という名前のセカンダリ データベースを、SecondaryServer\Instance という名前のサーバー インスタンスによってホストされているセカンダリ レプリカから削除します。 削除されたセカンダリ データベースへのデータ同期が停止します。 このコマンドは、プライマリ データベースまたはその他のセカンダリ データベースには影響しません。
このセカンダリ データベースのデータ同期を再開するには、同じサーバー インスタンスで Add-SqlAvailabilityDatabase コマンドレットを実行して可用性グループに再参加します。
例 4: 可用性グループからデータベースを削除するスクリプトを作成する
PS C:\> Remove-SqlAvailabilityDatabase -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityDatabases\Database16" -Script
このコマンドは、MainAG という名前の可用性グループから Database16 という名前の可用性データベースを削除する Transact-SQL スクリプトを作成します。 このコマンドでは、このアクションは実行されません。
パラメーター
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-InputObject
このコマンドレットによって削除される AvailabilityDatabase オブジェクトとして、可用性データベースを指定します。
パラメーターのプロパティ
| 型: | AvailabilityDatabase[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ByObject
| 配置: | 2 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Path
コマンドレットによって削除される可用性データベースのパスを指定します。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ByPath
| 配置: | 2 |
| 必須: | True |
| パイプラインからの値: | 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.AvailabilityDatabase
可用性データベースをこのコマンドレットに渡すことができます。