Delen via


sysmail_update_profile_sp (Transact-SQL)

Van toepassing op:SQL Server

Hiermee wijzigt u de beschrijving of naam van een Database Mail-profiel.

Transact-SQL syntaxis-conventies

Syntaxis

sysmail_update_profile_sp [ [ @profile_id = ] profile_id , ] [ [ @profile_name = ] 'profile_name' , ]
    [ [ @description = ] 'description' ]
[ ; ]

Argumenten

[ @profile_id = ] profile_id

De profiel-id die moet worden bijgewerkt. @profile_id is int, met een standaardwaarde van NULL. Er moet ten minste één van @profile_id of @profile_name worden opgegeven. Als beide zijn opgegeven, wordt met de procedure de naam van het profiel gewijzigd.

[ @profile_name = ] 'profile_name'

De naam van het profiel dat moet worden bijgewerkt of de nieuwe naam voor het profiel. @profile_name is sysname, met een standaardwaarde van NULL. Er moet ten minste één van @profile_id of @profile_name worden opgegeven. Als beide zijn opgegeven, wordt met de procedure de naam van het profiel gewijzigd.

[ @description = ] 'beschrijving'

De nieuwe beschrijving voor het profiel. @description is nvarchar(256), met een standaardwaarde van NULL.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Opmerkingen

Wanneer zowel de profiel-id als de profielnaam zijn opgegeven, wordt de naam van het profiel gewijzigd in de opgegeven naam en wordt de beschrijving voor het profiel bijgewerkt. Wanneer slechts één van deze argumenten wordt opgegeven, wordt met de procedure de beschrijving voor het profiel bijgewerkt.

De opgeslagen procedure sysmail_update_profile_sp bevindt zich in de msdb database en is eigendom van het dbo-schema . De procedure moet worden uitgevoerd met een driedelige naam als de huidige database dat niet msdbis.

Machtigingen

U kunt EXECUTE machtigingen verlenen voor deze procedure, maar deze machtigingen worden mogelijk overschreven tijdens een SQL Server-upgrade.

Voorbeelden

Eén. De beschrijving van een profiel wijzigen

In het volgende voorbeeld wordt de beschrijving gewijzigd voor het profiel dat in de msdb database wordt genoemdAdventureWorks Administrator.

EXECUTE msdb.dbo.sysmail_update_profile_sp
    @profile_name = 'AdventureWorks Administrator',
    @description = 'Administrative mail profile.';

B. De naam en beschrijving van een profiel wijzigen

In het volgende voorbeeld wordt de naam en beschrijving van het profiel gewijzigd met de profiel-id 750.

EXECUTE msdb.dbo.sysmail_update_profile_sp
    @profile_id = 750,
    @profile_name = 'Operator',
    @description = 'Profile to send alert e-mail to operators.';