sysmail_delete_principalprofile_sp (Transact-SQL)

  • Articolo

Si applica a:SQL Server

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

Convenzioni di 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 o del msdb ruolo del database nel database per l'associazione da eliminare. @principal_id è int, con il valore predefinito .NULL Per rendere un profilo pubblico in un profilo privato, specificare l'ID 0 entità o il nome publicdell'entità . È necessario specificare @principal_id o @principal_name .

[ @principal_name = ] 'principal_name'

Nome dell'utente o del ruolo del database nel msdb database per l'associazione da eliminare. @principal_name è sysname, con il valore predefinito NULL. Per rendere un profilo pubblico in un profilo privato, specificare l'ID 0 entità o il nome publicdell'entità . È necessario specificare @principal_id o @principal_name .

[ @profile_id = ] profile_id

ID del profilo da eliminare per l'associazione. @profile_id è int, con il valore predefinito NULL. È necessario specificare @profile_id o @profile_name .

[ @profile_name = ] 'profile_name'

Nome del profilo da eliminare per l'associazione. @profile_name è sysname, con il valore predefinito NULL. È necessario specificare @profile_id o @profile_name .

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Osservazioni:

Per rendere un profilo pubblico in un profilo privato, specificare "public" per il nome dell'entità o 0 per l'ID 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 causa l'esito negativo delle chiamate sp_send_dbmail . Per altre informazioni, vedere sp_send_dbmail (Transact-SQL).

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

Autorizzazioni

Questa stored procedure è di proprietà del ruolo db_owner . È possibile concedere EXECUTE autorizzazioni per qualsiasi utente, ma queste autorizzazioni possono essere sottoposte a override durante un aggiornamento di SQL Server.

Esempi

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

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

Contenuto correlato