sp_add_proxy (Transact-SQL)

Van toepassing op:SQL Server

Voegt de gespecificeerde SQL Server Agent-proxy toe.

Transact-SQL syntaxis-conventies

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

Arguments

[ @proxy_name = ] N'proxy_name'

De naam van de proxy die gecreëerd moet worden. De @proxy_name is sysname, met als standaard .NULL Wanneer de @proxy_name een lege string is NULL , wordt de naam van de proxy standaard de @credential_name of @credential_id aangeleverd.

[ @enabled = ] ingeschakeld

Geeft aan of de proxy is ingeschakeld. De @enabled-vlag is tinyint, met als standaard .1 Wanneer @enabled is 0, is de proxy niet ingeschakeld en kan niet door een taakstap worden gebruikt.

[ @description = ] Beschrijving van'

Een beschrijving van de proxy. De beschrijving is nvarchar(512), met als standaard .NULL De beschrijving laat je de proxy documenteren, maar wordt verder niet gebruikt door de SQL Server Agent. Daarom is dit argument optioneel.

[ @credential_name = ] N'credential_name'

De naam van het credential voor de proxy. De @credential_name is sysname, met als standaard .NULL Zowel @credential_name als @credential_id moeten worden gespecificeerd.

[ @credential_id = ] credential_id

Het identificatienummer van het credential voor de proxy. De @credential_id is int, met als standaard .NULL Zowel @credential_name als @credential_id moeten worden gespecificeerd.

[ @proxy_id = ] proxy_id OUTPUT

Het proxy-identificatienummer wordt aan de proxy toegewezen als het succesvol is aangemaakt.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Resultaatset

None.

Remarks

Deze opgeslagen procedure moet in de msdb database worden uitgevoerd.

Een SQL Server Agent proxy beheert de beveiliging voor taakstappen die subsystemen betreffen die niet het Transact-SQL subsysteem betreffen. Elke proxy komt overeen met een beveiligingsreferentie. Een proxy kan toegang hebben tot een willekeurig aantal subsystemen.

Permissions

Je kunt rechten verlenen EXECUTE op deze procedure, maar deze rechten kunnen worden overschreven tijdens een SQL Server-upgrade.

Leden van de sysadmin-vaste beveiligingsrol kunnen taakstappen maken die elke proxy gebruiken. Gebruik de opgeslagen procedure sp_grant_login_to_proxy om andere inloggegevens toegang te geven tot de proxy.

Examples

Dit voorbeeld creëert een proxy voor het credential CatalogApplicationCredential. De code gaat ervan uit dat het inlogement al bestaat. Voor meer informatie over kwalificaties zie CREATE CREDENTIAL.

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

Verwante inhoud

  • Last updated on