sp_remove_job_from_targets (Transact-SQL)

Artikel
2025-01-02

Gilt für: SQL Server

Entfernt den angegebenen Auftrag auf den jeweiligen Zielservern oder Zielservergruppen.

Syntax

sp_remove_job_from_targets
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @target_server_groups = ] N'target_server_groups' ]
    [ , [ @target_servers = ] N'target_servers' ]
[ ; ]

Argumente

[ @job_id = ] 'job_id'

Die Auftrags-ID des Auftrags, aus dem die angegebenen Zielserver oder Zielservergruppen entfernt werden sollen. @job_id ist eindeutiger Bezeichner mit einem Standardwert von NULL.

Entweder @job_id oder @job_name müssen angegeben werden, beide können jedoch nicht angegeben werden.

[ @job_name = ] N'job_name'

Der Name des Auftrags, aus dem die angegebenen Zielserver oder Zielservergruppen entfernt werden sollen. @job_name ist "sysname" mit der Standardeinstellung "NULL.

Entweder @job_id oder @job_name müssen angegeben werden, beide können jedoch nicht angegeben werden.

[ @target_server_groups = ] N'target_server_groups'

Eine durch Trennzeichen getrennte Liste der Zielservergruppen, die aus dem angegebenen Auftrag entfernt werden sollen. @target_server_groups ist "nvarchar(1024)" mit einem Standardwert von NULL.

[ @target_servers = ] N'target_servers'

Eine durch Trennzeichen getrennte Liste der Zielserver, die aus dem angegebenen Auftrag entfernt werden sollen. @target_servers ist nvarchar(1024), mit einem Standardwert von NULL.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Berechtigungen

Berechtigungen zur Ausführung dieser Prozedur erhalten standardmäßig Mitglieder der festen Serverrolle sysadmin .

Beispiele

Im folgenden Beispiel wird der zuvor erstellte Auftrag Weekly Sales Backups aus der Zielservergruppe Servers Processing Customer Orders und von den Servern SEATTLE1 und SEATTLE2 entfernt.

USE msdb;
GO

EXEC dbo.sp_remove_job_from_targets
    @job_name = N'Weekly Sales Backups',
    @target_server_groups = N'Servers Processing Customer Orders',
    @target_servers = N'SEATTLE2,SEATTLE1';
GO

Freigeben über