sp_add_proxy (Transact-SQL)

Artikel
06/18/2013

Fügt den angegebenen SQL Server Agent-Proxy hinzu.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

sp_add_proxy
    [ @proxy_name = ] 'proxy_name' ,
    [ @enabled = ] is_enabled ,
    [ @description = ] 'description' ,
    [ @credential_name = ] 'credential_name' ,
    [ @credential_id = ] credential_id ,
    [ @proxy_id = ] id OUTPUT

Argumente

[ @proxy_name= ] 'proxy_name'
Der Name des zu erstellenden Proxys. proxy_name ist vom Datentyp sysname und hat den Standardwert NULL. Wenn proxy_name den Wert NULL aufweist oder eine leere Zeichenfolge ist, wird standardmäßig der angegebene Wert für user_name als Name für den Proxy verwendet.
[ @enabled = ] is_enabled
Gibt an, ob der Proxy aktiviert ist. Der is_enabled-Flag ist tinyint. Der Standardwert beträgt 1. Wenn für is_enabled der Wert 0 festgelegt ist, ist der Proxy nicht aktiviert und kann nicht von einem Auftragsschritt verwendet werden.
[ @description= ] 'description'
Eine Beschreibung des Proxys. Die Beschreibung ist vom Datentyp nvarchar(512) und hat den Standardwert NULL. Mit der Beschreibung können Sie den Proxy dokumentieren. Sie erfüllt keine weiteren Aufgaben für den SQL Server-Agent. Daher ist dieses Argument optional.
[ @credential_name = ] 'credential_name'
Der Name der Anmeldeinformationen für den Proxy. credential_name ist vom Datentyp sysname und hat den Standardwert NULL. Es muss entweder credential_name oder credential_id angegeben werden.
[ @credential_id = ] credential_id
Die ID der Anmeldeinformationen für den Proxy. credential_id ist vom Datentyp int und hat den Standardwert NULL. Es muss entweder credential_name oder credential_id angegeben werden.
[ @proxy_id= ] id OUTPUT
Die Proxy-ID, die dem Proxy bei erfolgreicher Erstellung zugewiesen wird.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Keine

Hinweise

Diese gespeicherte Prozedur muss in der msdb-Datenbank ausgeführt werden.

Von einem SQL Server-Agent-Proxy wird die Sicherheit für Auftragsschritte verwaltet, die andere Subsysteme als das Transact-SQL-Subsystem verwenden. Jeder Proxy entspricht bestimmten Sicherheitsanmeldeinformationen. Ein Proxy kann über Zugriff auf eine beliebige Anzahl von Subsystemen verfügen.

Berechtigungen

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

Mitglieder der festen Sicherheitsrolle sysadmin können Auftragsschritte erstellen, die einen beliebigen Proxy verwenden. Verwenden Sie die gespeicherte Prozedur sp_grant_login_to_proxy (Transact-SQL), um anderen Anmeldenamen den Zugriff auf den Proxy zu gewähren.

Beispiele

In diesem Beispiel wird ein Proxy für die Anmeldeinformationen CatalogApplicationCredential erstellt. Es wird im Code vorausgesetzt, dass die Anmeldeinformationen bereits vorhanden sind. Weitere Informationen zu Anmeldeinformationen finden Sie unter CREATE CREDENTIAL (Transact-SQL).

USE msdb ;
GO

EXEC dbo.sp_add_proxy
    @proxy_name = 'Catalog application proxy',
    @enabled = 1,
    @description = 'Maintenance tasks on catalog application.',
    @credential_name = 'CatalogApplicationCredential' ;
GO