sp_update_proxy (Transact-SQL)

  • Artikel

Gilt für:SQL Server

Ändert die Eigenschaften eines vorhandenen Proxys.

Transact-SQL-Syntaxkonventionen

Syntax

sp_update_proxy
    [ [ @proxy_id = ] proxy_id ]
    [ , [ @proxy_name = ] N'proxy_name' ]
    [ , [ @credential_name = ] N'credential_name' ]
    [ , [ @credential_id = ] credential_id ]
    [ , [ @new_name = ] N'new_name' ]
    [ , [ @enabled = ] enabled ]
    [ , [ @description = ] N'description' ]
[ ; ]

Argumente

[ @proxy_id = ] proxy_id

Die Proxy-ID des Proxys, der geändert werden soll. @proxy_id ist int mit einem Standardwert von NULL.

[ @proxy_name = ] N'proxy_name'

Der Name des Proxys, der geändert werden soll. @proxy_name ist "sysname" mit der Standardeinstellung "NULL.

[ @credential_name = ] N'credential_name'

Der Name der neuen Anmeldeinformationen für den Proxy. @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 neuen Anmeldeinformationen für den Proxy. @credential_id ist int mit einem Standardwert von NULL. Entweder @credential_name oder @credential_id müssen angegeben werden.

[ @new_name = ] N'new_name'

Der neue Name des Proxys. @new_name ist "sysname" mit der Standardeinstellung "NULL. Wenn angegeben, ändert die Prozedur den Namen des Proxys in @new_name. Wenn dieses Argument lautet, wird NULLder Name des Proxys unverändert Standard.

[ @enabled = ] aktiviert

Gibt an, ob der Proxy aktiviert ist. @enabled ist winzig, mit einem Standardwert von NULL. Wenn @enabled ist, ist 0der Proxy nicht aktiviert und kann nicht von einem Auftragsschritt verwendet werden. Wenn dieses Argument lautet, wird NULLder Status des Proxys unverändert Standard.

[ @description = ] N'description'

Die neue Beschreibung des Proxys. @description ist nvarchar(512), mit einem Standardwert von NULL. Wenn dieses Argument lautet, wird NULLdie Beschreibung des Proxys unverändert Standard.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler).

Hinweise

Entweder @proxy_name oder @proxy_id müssen 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 müssen 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 diesem Verfahren wird der Proxy geändert, der Zugriff auf den Proxy wird jedoch nicht geändert. Um den Zugriff auf einen Proxy zu ändern, verwenden sp_grant_login_to_proxy sie 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

Zugehöriger Inhalt