sp_add_proxy (Transact-SQL)

Gilt für:SQL Server

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

Transact-SQL-Syntaxkonventionen

Syntax

dbo.sp_add_proxy
    [ @proxy_name = ] N'proxy_name'
    [ , [ @enabled = ] enabled ]
    [ , [ @description = ] N'description' ]
    , { [ @credential_name = ] N'credential_name'
        | [ @credential_id = ] credential_id }
    [ , [ @proxy_id = ] proxy_id OUTPUT ]
[ ; ]

Argumente

[ @proxy_name = ] N'proxy_name'

Der Name des zu erstellenden Proxys. Die @proxy_name ist "sysname" mit der Standardeinstellung ".NULL Wenn die @proxy_name eine leere Zeichenfolge ist oder eine leere Zeichenfolge ist NULL , wird der Name des Proxys standardmäßig auf den angegebenen @credential_name oder @credential_id festgelegt.

[ @enabled = ] aktiviert

Gibt an, ob der Proxy aktiviert ist. Das 1 . Wenn @enabled ist, ist 0der Proxy nicht aktiviert und kann nicht von einem Auftragsschritt verwendet werden.

[ @description = ] N'description'

Eine Beschreibung des Proxys. Die Beschreibung ist nvarchar(512), mit einem Standardwert von NULL. Die Beschreibung ermöglicht es Ihnen, den Proxy zu dokumentieren, wird jedoch nicht anderweitig von SQL Server-Agent verwendet. Daher ist dieses Argument optional.

[ @credential_name = ] N'credential_name'

Der Name der Anmeldeinformationen für den Proxy. Die @credential_name ist "sysname" mit einem Standardwert von NULL. Entweder @credential_name oder @credential_id müssen angegeben werden.

[ @credential_id = ] credential_id

Die ID der Anmeldeinformationen für den Proxy. Die @credential_id ist int mit einem Standardwert von NULL. Entweder @credential_name oder @credential_id müssen angegeben werden.

[ @proxy_id = ] proxy_id AUSGABE

Die Proxy-ID, die dem Proxy bei erfolgreicher Erstellung zugewiesen wird.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Resultset

Keine.

Hinweise

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

Ein SQL Server-Agent Proxy verwaltet die Sicherheit für Auftragsschritte, die andere Subsysteme als das Transact-SQL-Subsystem umfassen. Jeder Proxy entspricht einem Satz Sicherheitsanmeldeinformationen. Ein Proxy hat möglicherweise Zugriff auf eine beliebige Anzahl von Subsystemen.

Berechtigungen

Sie können Berechtigungen für dieses Verfahren erteilen EXECUTE , aber diese Berechtigungen können während eines SQL Server-Upgrades außer Kraft gesetzt werden.

Mitglieder der festen Sicherheitsrolle "sysadmin " können Auftragsschritte erstellen, die einen beliebigen Proxy verwenden. Verwenden Sie die gespeicherte Prozedur sp_grant_login_to_proxy , um anderen Anmeldeinformationen 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 Qualifikationen finden CREATE CREDENTIALSie unter .

USE msdb;
GO

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