Remove-SqlAvailabilityDatabase

モジュール:

SQLPS

可用性グループから可用性データベースを削除します。

構文

Remove-SqlAvailabilityDatabase
      [-Path] <String[]>
      [-Script]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

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"

このコマンドは、Database16 という名前の可用性データベースを MainAG という名前の可用性グループから削除します。 このコマンドは、プライマリ レプリカをホストするサーバー インスタンスで実行されます。 そのため、プライマリ データベースとそれに対応するすべてのセカンダリ データベースが可用性グループから削除されます。 セカンダリ レプリカでこのデータベースに対してデータ同期が行われなくなりました。

例 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

このコマンドは、Database16 という可用性データベースを MainAG という名前の可用性グループから削除する Transact-SQL スクリプトを作成します。 コマンドは、このアクションを実行しません。

パラメーター

-Confirm

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

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

-InputObject

このコマンドレットによって削除される AvailabilityDatabase オブジェクトとして、可用性データベースを指定します。

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

-Path

コマンドレットによって削除される可用性データベースのパスを指定します。

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

-Script

このコマンドレットによって、このコマンドレットが実行するタスクを実行する Transact-SQL スクリプトが返されることを示します。

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

-WhatIf

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

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

入力

Microsoft.SqlServer.Management.Smo.AvailabilityDatabase

可用性データベースをこのコマンドレットに渡すことができます。

関連リンク

• Add-SqlAvailabilityDatabase
• Resume-SqlAvailabilityDatabase
• Suspend-SqlAvailabilityDatabase