Freigeben über

  • Artikel

sp_apply_job_to_targets (Transact-SQL)

Wendet einen Auftrag auf einen oder mehrere Zielserver oder auf die Zielserver an, die einer oder mehreren Zielservergruppen angehören.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

sp_apply_job_to_targets { [ @job_id = ] job_id | [ @job_name = ] 'job_name' }
     [ , [ @target_server_groups = ] 'target_server_groups' ] 
     [ , [ @target_servers = ] 'target_servers' ] 
     [ , [ @operation = ] 'operation' ]

Argumente

  • [ @job_id =] job_id
    Die ID des Auftrags, der auf die angegebenen Zielserver oder Zielservergruppen angewendet werden soll. job_id ist ein Wert vom Datentyp uniqueidentifier; der Standardwert ist NULL.

  • [ @job_name = ] 'job_name'
    Der Name des Auftrags, der auf die angegebenen Zielserver oder Zielservergruppen angewendet werden soll. job_name ist ein Wert vom Datentyp sysname; der Standardwert ist NULL.

    HinweisHinweis

    Es muss entweder job_id oder job_name angegeben werden, die Angabe beider Argumente gleichzeitig ist nicht möglich.

  • [ @target_server_groups =] 'target_server_groups'
    Eine durch Trennzeichen getrennte Liste mit Zielservergruppen, auf die der angegebene Auftrag angewendet werden soll. target_server_groups ist ein Wert vom Datentyp nvarchar(2048); der Standardwert ist NULL.

  • [ @target_servers= ] 'target_servers'
    Eine durch Trennzeichen getrennte Liste mit Zielservern, auf die der angegebene Auftrag angewendet werden soll. target_serversist ein Wert vom Datentyp nvarchar(2048); der Standardwert ist NULL.

  • [ @operation= ] 'operation'
    Bestimmt, ob der angegebene Auftrag angewendet oder von den angegebenen Zielservern oder Zielservergruppen entfernt werden soll. operationist ein Wert vom Datentyp varchar(7); der Standardwert ist APPLY. Gültige Operationen sind APPLY und REMOVE.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_apply_job_to_targets stellt ein einfaches Verfahren bereit, um einen Auftrag auf mehrere Zielserver anzuwenden (oder von ihnen zu entfernen), und stellt eine Alternative zum Aufrufen von sp_add_jobserver (oder sp_delete_jobserver) für jeden erforderlichen Zielserver dar.

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin können diese Prozedur ausführen.

Beispiele

Im folgenden Beispiel wird der zuvor erstellte Auftrag Backup Customer Information auf alle Zielserver in der Gruppe Servers Maintaining Customer Information angewendet.

USE msdb ;
GO

EXEC dbo.sp_apply_job_to_targets
    @job_name = N'Backup Customer Information',
    @target_server_groups = N'Servers Maintaining Customer Information', 
    @operation = N'APPLY' ;
GO