Freigeben über

  • Artikel

sp_add_proxy (Transact-SQL)

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 ein Wert vom Datentyp sysname. Der Standardwert ist 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. Das is_enabled-Flag ist ein Wert vom Datentyp tinyint. Der Standardwert ist 1. Wenn is_enabled den Wert 0 aufweist, ist der Proxy nicht aktiviert und kann von einem Auftragsschritt nicht verwendet werden.

  • [ @description= ] 'description'
    Eine Beschreibung des Proxys. Die Beschreibung ist ein Wert vom Datentyp nvarchar(512). Der Standardwert ist 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 ein Wert vom Datentyp sysname. Der Standardwert ist 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 ein Wert vom Datentyp int. Der Standardwert ist 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