sp_delete_targetserver (Transact-SQL)

適用対象:SQL Server

指定したサーバーを、使用可能なターゲット サーバーの一覧から削除します。

Transact-SQL 構文表記規則

構文

sp_delete_targetserver
    [ @server_name = ] N'server_name'
    [ , [ @clear_downloadlist = ] clear_downloadlist ]
    [ , [ @post_defection = ] post_defection ]
[ ; ]

引数

[ @server_name = ] N'server_name'

利用可能なターゲット サーバーから削除するサーバーの名前を指定します。 @server_nameは sysname で、既定値はありません。

[ @clear_downloadlist = ] clear_downloadlist

ターゲット サーバーのダウンロード リストをクリアするかどうかを指定します。 @clear_downloadlistはビットで、既定値は 1.

• @clear_downloadlist1すると、サーバーを削除する前に、サーバーのダウンロード リストがクリアされます。
• @clear_downloadlistすると0、ダウンロード リストはクリアされません。

[ @post_defection = ] post_defection

ターゲット サーバーに参加解除の命令を投稿するかどうかを指定します。 @post_defectionはビットで、既定値は 1.

• @post_defectionの場合、プロシージャは1、サーバーを削除する前に、ターゲット サーバーにディフェクト命令をポストします。
• @post_defectionの0場合、プロシージャはターゲット サーバーにディフェクト命令を送信しません。

リターン コードの値

0 (成功) または 1 (失敗)。

結果セット

ありません。

解説

ターゲット サーバーを削除する通常の方法は、ターゲット サーバーで呼び出し sp_msx_defect を行う方法です。 手動による欠陥が必要な場合にのみ使用 sp_delete_targetserver してください。

アクセス許可

このストアド プロシージャを実行するには、ユーザーに sysadmin 固定サーバー ロールを付与する必要があります。

例

次の例では、使用可能なジョブ サーバーからサーバー LONDON1 を削除します。

USE msdb;
GO

EXEC dbo.sp_delete_targetserver
    @server_name = N'LONDON1';
GO

関連するコンテンツ

• sp_help_targetserver (Transact-SQL)
• sp_msx_defect (Transact-SQL)
• システム ストアド プロシージャ (Transact-SQL)