sp_update_proxy (Transact-SQL)

Gäller för:SQL Server

Ändrar egenskaperna hos en befintlig proxy.

Transact-SQL syntaxkonventioner

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' ]
[ ; ]

Arguments

[ @proxy_id = ] proxy_id

Proxyns identifikationsnummer för proxyn ska ändras. @proxy_id är int, med standardvärdet .NULL

[ @proxy_name = ] N'proxy_name'

Namnet på proxyn för att byta ut. @proxy_name är sysname, med standardvärdet .NULL

[ @credential_name = ] N'credential_name'

Namnet på den nya legitimationen för fullmakten. @credential_name är sysname, med standardvärdet .NULL Antingen @credential_name eller @credential_id måste specificeras.

[ @credential_id = ] credential_id

Identifikationsnumret för den nya legitimationen för proxyn. @credential_id är int, med standardvärdet .NULL Antingen @credential_name eller @credential_id måste specificeras.

[ @new_name = ] N'new_name'

Det nya namnet på proxyn. @new_name är sysname, med standardvärdet .NULL När den finns ändrar proceduren proxyns namn till @new_name. När detta argument är NULL, förblir proxyns namn oförändrat.

[ @enabled = ] aktiverat

Specificerar om proxyn är aktiverad. @enabled är tinyint, med standardvärdet .NULL När @enabled är 0, är proxyn inte aktiverad och kan inte användas av ett jobbsteg. När detta argument är NULL, förblir proxyns status oförändrad.

[ @description = ] Ingen beskrivning'

Den nya beskrivningen av proxyn. @description är nvarchar(512), med standardvärdet .NULL När detta argument är NULL, förblir beskrivningen av proxyn oförändrad.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Anmärkningar

Antingen @proxy_name eller @proxy_id måste specificeras. Om båda argumenten specificeras måste argumenten referera till samma proxy, annars misslyckas den lagrade proceduren.

Antingen @credential_name eller @credential_id måste specificeras för att ändra inloggningsuppgifterna för proxyn. Om båda argumenten anges måste argumenten hänvisa till samma legitimation annars misslyckas den lagrade proceduren.

Denna promotor ändrar proxyn, men ändrar inte åtkomsten till proxyn. För att ändra åtkomst till en proxy, använd sp_grant_login_to_proxy och sp_revoke_login_from_proxy.

Permissions

Endast medlemmar i sysadmin-fasta säkerhetsrollen kan utföra denna procedur.

Examples

Följande exempel sätter det aktiverade värdet för proxyn Catalog application proxy till 0.

USE msdb;
GO

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