sp_remove_job_from_targets (Transact-SQL)

Artikel
12/22/2023

Entfernt den angegebenen Auftrag auf den jeweiligen Zielservern oder Zielservergruppen.

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 Auftragsidentifikationsnummer des Auftrags, aus dem die angegebenen Zielserver oder Zielservergruppen entfernt werden sollen. Entweder job_id oder job_name müssen angegeben werden, beide können jedoch nicht angegeben werden. job_id ist eindeutiger Bezeichner mit einem Standardwert von NULL.

[ @job_name = ] 'job_name' Der Name des Auftrags, aus dem die angegebenen Zielserver oder Zielservergruppen entfernt werden sollen. Entweder job_id oder job_name müssen angegeben werden, beide können jedoch nicht angegeben werden. job_name ist "sysname" mit dem Standardwert 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 nvarchar(1024), wobei der Standardwert NULL ist.

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

Rückgabecodewerte

0 (Erfolg) 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

Weitere Informationen

sp_apply_job_to_targets (Transact-SQL)
sp_delete_jobserver (Transact-SQL)
Gespeicherte Systemprozeduren (Transact-SQL)