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

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

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

Type:	AvailabilityDatabase[]
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Path

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

Type:	String[]
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Script

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

入力

Microsoft.SqlServer.Management.Smo.AvailabilityDatabase

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