sp_apply_job_to_targets (Transact-SQL)

  • Artikel

Gilt für:SQL Server

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

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @job_id = ] 'job_id'

Die ID des Auftrags, der für die angegebenen Zielserver oder Zielservergruppen ausgeführt 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, der für die angegebenen Zielserver oder Zielservergruppen ausgeführt 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 von Zielservergruppen, für die der angegebene Auftrag ausgeführt werden soll. @target_server_groups ist nvarchar(2048), mit einem Standardwert von NULL.

[ @target_servers = ] N'target_servers'

Eine durch Trennzeichen getrennte Liste von Zielservern, für die der angegebene Auftrag ausgeführt werden soll. @target_servers ist nvarchar(2048), mit einem Standardwert von NULL.

[ @operation = ] 'operation'

Gibt an, ob der angegebene Auftrag auf die angegebenen Zielserver oder Zielservergruppen angewendet oder daraus entfernt werden soll. @operation ist varchar(7) mit einem Standardwert von APPLY. Gültige Vorgänge sind APPLY und REMOVE.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Hinweise

sp_apply_job_to_targets bietet eine einfache Möglichkeit zum Anwenden (oder Entfernen) eines Auftrags von mehreren Zielservern und ist eine Alternative zum Aufrufen sp_add_jobserver (oder sp_delete_jobserver) einmal für jeden erforderlichen Zielserver.

Berechtigungen

Diese gespeicherte Prozedur gehört der db_owner Rolle. Sie können berechtigungen für jeden Benutzer erteilen EXECUTE , diese Berechtigungen können jedoch während eines SQL Server-Upgrades außer Kraft gesetzt werden.

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

Zugehöriger Inhalt