sysmail_delete_principalprofile_sp (Transact-SQL)

Rimuove l'autorizzazione per un utente o ruolo del database per l'utilizzo di un profilo di Posta elettronica database pubblico o privato.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

sysmail_delete_principalprofile_sp  { [ @principal_id = ] principal_id | [ @principal_name = ] 'principal_name' } ,
    { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' }

Argomenti

  • [ @principal_id = ] principal_id
    ID dell'utente del database o del ruolo nel database msdb per l'associazione da eliminare. principal_id è di tipo int e il valore predefinito è NULL. Per trasformare un profilo pubblico in profilo privato, immettere l'ID di entità 0 o il nome di entità 'public'. È necessario specificare l'argomento principal_id o l'argomento principal_name.

  • [ @principal_name = ] 'principal_name'
    Nome dell'utente del database o del ruolo nel database msdb per l'associazione da eliminare. principal_name è di tipo sysname e il valore predefinito è NULL. Per trasformare un profilo pubblico in profilo privato, immettere l'ID di entità 0 o il nome di entità 'public'. È necessario specificare l'argomento principal_id o l'argomento principal_name.

  • [ @profile_id = ] profile_id
    ID del profilo per l'associazione da eliminare. profile_id è di tipo int e il valore predefinito è NULL. È necessario specificare l'argomento profile_id o l'argomento profile_name.

  • [ @profile_name = ] 'profile_name'
    Nome del profilo per l'associazione da eliminare. profile_name è di tipo sysname e il valore predefinito è NULL. È necessario specificare l'argomento profile_id o l'argomento profile_name.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Osservazioni

Per trasformare un profilo pubblico in profilo privato, immettere 'public' per il nome di entità o 0 per l'ID di entità.

Prestare attenzione quando si rimuovono le autorizzazioni per il profilo privato predefinito di un utente o per il profilo pubblico predefinito. Quando non è disponibile alcun profilo predefinito, sp_send_dbmail richiede il nome di un profilo come argomento. Pertanto, la rimozione di un profilo predefinito potrebbe impedire l'esecuzione delle chiamate a sp_send_dbmail. Per ulteriori informazioni, vedere sp_send_dbmail (Transact-SQL).

La stored procedure sysmail_delete_principalprofile_sp si trova nel database msdb ed è di proprietà dello schema dbo. La procedura deve essere eseguita con un nome in tre parti se il database corrente non è msdb.

Autorizzazioni

Le autorizzazioni di esecuzione per questa procedura vengono assegnate per impostazione predefinita ai membri del ruolo predefinito del server sysadmin.

Esempi

Nell'esempio seguente viene illustrata l'eliminazione dell'associazione tra il profilo AdventureWorks Administrator e l'account di accesso ApplicationUser nel database msdb.

EXECUTE msdb.dbo.sysmail_delete_principalprofile_sp
    @principal_name = 'ApplicationUser',
    @profile_name = 'AdventureWorks Administrator' ;