sp_update_proxy (Transact-SQL)

Ändert die Eigenschaften eines vorhandenen Proxys.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

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'

Argumente

  • [ @proxy_id= ] id
    Die Proxy-ID des Proxys, der geändert werden soll. proxy_id ist ein Wert vom Datentyp int. Der Standardwert ist NULL.

  • [ @proxy_name= ] 'proxy_name'
    Der Name des Proxys, der geändert werden soll. proxy_name ist ein Wert vom Datentyp sysname. Der Standardwert ist NULL.

  • [ @credential_name = ] 'credential_name'
    Der Name der neuen Anmeldeinformationen für den Proxy. credential_name ist ein Wert vom Datentyp sysname. Der Standardwert ist NULL. Es kann entweder credential_name oder credential_id angegeben werden.

  • [ @credential_id = ] credential_id
    Die ID der neuen Anmeldeinformationen für den Proxy. credential_id ist ein Wert vom Datentyp int. Der Standardwert ist NULL. Es kann entweder credential_name oder credential_id angegeben werden.

  • [ @new_name= ] 'new_name'
    Der neue Name des Proxys. new_name ist ein Wert vom Datentyp sysname. Der Standardwert ist NULL. Wird hier ein Wert eingegeben, wird mit dieser Prozedur der Name des Proxys in new_name geändert. Wenn für das Argument NULL festgelegt wird, bleibt der Name des Proxys unverändert.

  • [ @enabled = ] is_enabled
    Gibt an, ob der Proxy aktiviert ist: is_enabled ist vom Datentyp tinyint; der Standardwert ist NULL. Wenn für is_enabled der Wert 0 festgelegt ist, ist der Proxy nicht aktiviert und kann nicht von einem Auftragsschritt verwendet werden.Wird für das Argument NULL festgelegt, bleibt der Status des Proxys unverändert.

  • [ @description= ] 'description'
    Die neue Beschreibung des Proxys. description ist ein Wert vom Datentyp nvarchar(512). Der Standardwert ist NULL.Wenn für das Argument NULL festgelegt wird, bleibt die Beschreibung des Proxys unverändert.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

Entweder @proxy_name oder @proxy_id muss angegeben werden. Wenn beide Argumente angegeben werden, müssen sie sich beide auf denselben Proxy beziehen. Andernfalls erzeugt die gespeicherte Prozedur einen Fehler.

Entweder @credential_name oder @credential_id muss angegeben werden, um die Anmeldeinformationen für den Proxy zu ändern. Wenn beide Argumente angegeben werden, müssen sich beide auf dieselben Anmeldeinformationen beziehen, andernfalls erzeugt die gespeicherte Prozedur einen Fehler.

Mit dieser Prozedur wird der Proxy geändert, jedoch nicht der Zugriff auf den Proxy. Zum Ändern des Zugriffs auf den Proxy verwenden Sie sp_grant_login_to_proxy und sp_revoke_login_from_proxy.

Berechtigungen

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

Beispiele

Im folgenden Beispiel wird der aktivierte Wert für den Proxy Catalog application proxy auf 0 festgelegt.

USE msdb ;
GO

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