sp_update_proxy (Transact-SQL)sp_update_proxy (Transact-SQL)

DIESES THEMA GILT FÜR:jaSQL Server (ab 2008)neinAzure SQL-DatenbankneinAzure SQL Data Warehouse neinParallel Data Warehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Ändert die Eigenschaften eines vorhandenen Proxys.Changes the properties of an existing proxy.

Themenlinksymbol Transact-SQL Syntax Conventions (Transact-SQL-Syntaxkonventionen)Topic link icon Transact-SQL Syntax Conventions

SyntaxSyntax


sp_update_proxy   
    [ @proxy_id = ] id,  
    [ @proxy_name = ] 'proxy_name',  
    [ @credential_name = ] 'credential_name' ,  
    [ @credential_id = ] credential_id ,  
    [ @new_name = ] 'new_name' ,  
    [ @enabled = ] is_enabled ,  
    [ @description = ] 'description'  

ArgumenteArguments

[ @proxy_id= ] id[ @proxy_id= ] id
Die Proxy-ID des Proxys, der geändert werden soll.The proxy identification number of the proxy to change. Die Proxy_id ist Int, hat den Standardwert NULL.The proxy_id is int, with a default of NULL.

[ @proxy_name=] "Proxy_name"[ @proxy_name= ] 'proxy_name'
Der Name des Proxys, der geändert werden soll.The name of the proxy to change. Die Proxy_name ist Sysname, hat den Standardwert NULL.The proxy_name is sysname, with a default of NULL.

[ @credential_name =] "Credential_name"[ @credential_name = ] 'credential_name'
Der Name der neuen Anmeldeinformationen für den Proxy.The name of the new credential for the proxy. Die Credential_name ist Sysname, hat den Standardwert NULL.The credential_name is sysname, with a default of NULL. Entweder Credential_name oder Credential_id kann angegeben werden.Either credential_name or credential_id may be specified.

[ @credential_id = ] credential_id[ @credential_id = ] credential_id
Die ID der neuen Anmeldeinformationen für den Proxy.The identification number of the new credential for the proxy. Die Credential_id ist Int, hat den Standardwert NULL.The credential_id is int, with a default of NULL. Entweder Credential_name oder Credential_id kann angegeben werden.Either credential_name or credential_id may be specified.

[ @new_name=] "New_name"[ @new_name= ] 'new_name'
Der neue Name des Proxys.The new name of the proxy. Die New_name ist Sysname, hat den Standardwert NULL.The new_name is sysname, with a default of NULL. Wenn angegeben, wird die Prozedur ändert den Namen des Proxys, für New_name.When provided, the procedure changes the name of the proxy to new_name. Wenn für das Argument NULL festgelegt wird, bleibt der Name des Proxys unverändert.When this argument is NULL, the name of the proxy remains unchanged.

[ @enabled =] Is_enabled[ @enabled = ] is_enabled
Gibt an, ob der Proxy aktiviert ist:Is whether the proxy is enabled. Die Is_enabled Flag "tinyint", hat den Standardwert NULL.The is_enabled flag is tinyint, with a default of NULL. Wenn Is_enabled ist 0, der Proxy nicht aktiviert und kann nicht von einem Auftragsschritt verwendet werden.When is_enabled is 0, the proxy is not enabled, and cannot be used by a job step. Wird für das Argument NULL festgelegt, bleibt der Status des Proxys unverändert.When this argument is NULL, the status of the proxy remains unchanged.

[ @description=] "Beschreibung"[ @description= ] 'description'
Die neue Beschreibung des Proxys.The new description of the proxy. Die Beschreibung ist vom Datentyp nvarchar(512), hat den Standardwert NULL.The description is nvarchar(512), with a default of NULL. Wenn für das Argument NULL festgelegt wird, bleibt die Beschreibung des Proxys unverändert.When this argument is NULL, the description of the proxy remains unchanged.

RückgabecodewerteReturn Code Values

0 (Erfolg) oder 1 (Fehler)0 (success) or 1 (failure)

HinweiseRemarks

Entweder @proxy_name oder @proxy_id muss angegeben werden.Either @proxy_name or @proxy_id must be specified. Wenn beide Argumente angegeben werden, müssen sie sich beide auf denselben Proxy beziehen. Andernfalls erzeugt die gespeicherte Prozedur einen Fehler.If both arguments are specified, the arguments must both refer to the same proxy or the stored procedure fails.

Entweder @credential_name oder @credential_id muss angegeben werden, um die Anmeldeinformationen für den Proxy zu ändern.Either @credential_name or @credential_id must be specified to change the credential for the proxy. Wenn beide Argumente angegeben werden, müssen sich beide auf dieselben Anmeldeinformationen beziehen, andernfalls erzeugt die gespeicherte Prozedur einen Fehler.If both arguments are specified, the arguments must refer to the same credential or the stored procedure fails.

Mit dieser Prozedur wird der Proxy geändert, jedoch nicht der Zugriff auf den Proxy.This procedure changes the proxy, but does not change access to the proxy. Um den Zugriff auf einen Proxy zu ändern, verwenden Sie Sp_grant_login_to_proxy und Sp_revoke_login_from_proxy.To change access to a proxy, use sp_grant_login_to_proxy and sp_revoke_login_from_proxy.

BerechtigungenPermissions

Nur Mitglieder der Sysadmin festen Sicherheitsrolle kann diese Prozedur ausführen.Only members of the sysadmin fixed security role can execute this procedure.

BeispieleExamples

Im folgenden Beispiel wird der aktivierte Wert für den Proxy Catalog application proxy auf 0 festgelegt.The following example sets the enabled value for the proxy Catalog application proxy to 0.

USE msdb ;  
GO  

EXEC dbo.sp_update_proxy  
    @proxy_name = 'Catalog application proxy',  
    @enabled = 0;  
GO  

Siehe auchSee Also

SQL Server-Agent-Prozeduren (Transact-SQL) SQL Server Agent Stored Procedures (Transact-SQL)
Implementieren von Sicherheit für SQL Server-Agent Implement SQL Server Agent Security
sp_add_proxy (Transact-SQL) sp_add_proxy (Transact-SQL)
sp_delete_proxy (Transact-SQL) sp_delete_proxy (Transact-SQL)
sp_grant_login_to_proxy (Transact-SQL) sp_grant_login_to_proxy (Transact-SQL)
sp_revoke_login_from_proxy (Transact-SQL)sp_revoke_login_from_proxy (Transact-SQL)