sysmail_delete_principalprofile_sp (Transact-SQL)
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 relative alla 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 public
dell'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 public
dell'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.
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
È possibile concedere EXECUTE
autorizzazioni per questa procedura, ma queste autorizzazioni potrebbero 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';