sp_apply_job_to_targets (Transact-SQL)

Applica un processo a uno o più server di destinazione o ai server appartenenti a uno o più gruppi di server di destinazione.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

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' ] 

Argomenti

  • [ @job_id =] job_id
    Numero di identificazione del processo da applicare ai server o ai gruppi di server di destinazione specificati. job_id è di tipo uniqueidentifier e il valore predefinito è NULL.

  • [ @job_name =] 'job_name'
    Nome del processo da applicare ai server o ai gruppi di server di destinazione specificati. job_name è di tipo sysname e il valore predefinito è NULL.

    [!NOTA]

    È necessario specificare l'argomento job_id oppure l'argomento job_name ma non è possibile specificarli entrambi.

  • [ @target_server_groups =] 'target_server_groups'
    Elenco delimitato da virgole dei gruppi di server di destinazione ai quali si desidera applicare il processo specificato. target_server_groups è di tipo nvarchar(2048) e il valore predefinito è NULL.

  • [ @target_servers= ] 'target_servers'
    Elenco delimitato da virgole dei server di destinazione ai quali si desidera applicare il processo specificato. target_serversè di tipo nvarchar(2048) e il valore predefinito è NULL.

  • [ @operation= ] 'operation'
    Indica se il processo specificato deve essere applicato o rimosso dai server o dai gruppi di server di destinazione specificati. operationè di tipo varchar(7) e il valore predefinito è APPLY. Le operazioni valide sono APPLY e REMOVE.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Osservazioni

La stored procedure sp_apply_job_to_targets rappresenta una soluzione semplice per applicare o rimuovere un processo in più server di destinazione e può essere utilizzata in alternativa alla chiamata di sp_add_jobserver o sp_delete_jobserver per ogni server di destinazione.

Autorizzazioni

Solo i membri del ruolo predefinito del server sysadmin possono eseguire questa procedura.

Esempi

Nell'esempio seguente il processo Backup Customer Information creato in precedenza viene applicato a tutti i server di destinazione nel gruppo Servers Maintaining Customer Information.

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