sp_remove_job_from_targets (Transact-SQL)

Entfernt den angegebenen Auftrag auf den jeweiligen Zielservern oder Zielservergruppen.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

sp_remove_job_from_targets [ @job_id = ] job_id 
     | [ @job_name = ] 'job_name' 
     [ , [ @target_server_groups = ] 'target_server_groups' ] 
     [ , [ @target_servers = ] 'target_servers' ]

Argumente

  • [ @job_id =] job_id
    Die Auftrags-ID des Auftrags, aus dem die angegebenen Zielserver oder Zielservergruppen entfernt werden sollen. Es muss entweder job_id oder job_id angegeben werden, beide Angaben sind jedoch nicht möglich. job_name ist vom Datentyp uniqueidentifier; der Standardwert ist NULL.

  • [ @job_name =] 'job_name'
    Der Name des Auftrags, aus dem die angegebenen Zielserver oder Zielservergruppen entfernt werden sollen. Es muss entweder job_id oder job_name angegeben werden, beide Angaben sind jedoch nicht möglich. job_name ist vom Datentyp sysname; der Standardwert ist NULL.

  • [ @target_server_groups =] 'target_server_groups'
    Eine durch Trennzeichen getrennte Liste der Zielservergruppen, die aus dem angegebenen Auftrag entfernt werden sollen. target_server_groups ist ein Wert vom Datentyp nvarchar(1024); der Standardwert ist NULL.

  • [ @target_servers =] 'target_servers'
    Eine durch Trennzeichen getrennte Liste der Zielserver, die aus dem angegebenen Auftrag entfernt werden sollen. target_servers ist ein Wert vom Datentyp nvarchar(1024); der Standardwert ist NULL.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Berechtigungen

Standardmäßig verfügen Mitglieder der festen Serverrolle sysadmin über Berechtigungen zum Ausführen dieser Prozedur.

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