Delen via


sysmail_delete_profileaccount_sp (Transact-SQL)

Van toepassing op:SQL Server

Hiermee verwijdert u een account uit een Database Mail-profiel.

Transact-SQL syntaxis-conventies

Syntaxis

sysmail_delete_profileaccount_sp { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' } ,
    { [ @account_id = ] account_id | [ @account_name = ] 'account_name' }
[ ; ]

Argumenten

[ @profile_id = ] profile_id

De profiel-id van het profiel dat u wilt verwijderen. @profile_id is int, met een standaardwaarde van NULL. De @profile_id of de @profile_name kunnen worden opgegeven.

[ @profile_name = ] 'profile_name'

De profielnaam van het profiel dat u wilt verwijderen. @profile_name is sysname, met een standaardwaarde van NULL. De @profile_id of de @profile_name kunnen worden opgegeven.

[ @account_id = ] account_id

De account-id die u wilt verwijderen. @account_id is int, met een standaardwaarde van NULL. De @account_id of de @account_name kunnen worden opgegeven.

[ @account_name = ] 'account_name'

De naam van het account dat u wilt verwijderen. @account_name is sysname, met een standaardwaarde van NULL. De @account_id of de @account_name kunnen worden opgegeven.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Resultaatset

Geen.

Opmerkingen

Retourneert een fout als het opgegeven account niet is gekoppeld aan het opgegeven profiel.

Wanneer een account is opgegeven, maar er geen profiel is opgegeven, wordt met deze opgeslagen procedure het opgegeven account uit alle profielen verwijderd. Als u bijvoorbeeld voorbereidt op het afsluiten van een bestaande SMTP-server, verwijdert u accounts die gebruikmaken van die SMTP-server uit alle profielen in plaats van elk account uit elk profiel te verwijderen.

Wanneer een profiel is opgegeven, maar er geen account is opgegeven, worden met deze opgeslagen procedure alle accounts uit het opgegeven profiel verwijderd. Als u bijvoorbeeld de SMTP-servers wijzigt die door een profiel worden gebruikt, is het handig om alle accounts uit het profiel te verwijderen en zo nodig nieuwe accounts toe te voegen.

De opgeslagen procedure sysmail_delete_profileaccount_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

In het volgende voorbeeld ziet u hoe u het account Audit Account uit het profiel AdventureWorks Administratorverwijdert.

EXECUTE msdb.dbo.sysmail_delete_profileaccount_sp
    @profile_name = 'AdventureWorks Administrator',
    @account_name = 'Audit Account';