sysmail_delete_profileaccount_sp (Transact-SQL)
從 Database Mail 設定檔中移除帳戶。
語法
sysmail_delete_profileaccount_sp { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' } ,
{ [ @account_id = ] account_id | [ @account_name = ] 'account_name' }
引數
- [ @profile_id = ] profile_id
要刪除之設定檔的識別碼。profile_id 是 int,預設值是 NULL。您只能指定 profile_id 或 profile_name 其中之一。
- [ @profile_name = ] 'profile_name'
要刪除的設定檔之設定檔名稱。profile_name 是 sysname,預設值是 NULL。您只能指定 profile_id 或 profile_name 其中之一。
- [ @account_id = ] account_id
要刪除的帳戶識別碼。account_id 是 int,預設值是 NULL。您只能指定 account_id 或 account_name 其中之一。
- [ @account_name = ] 'account_name'
要刪除的帳戶名稱。account_name 是 sysname,預設值是 NULL。您只能指定 account_id 或 account_name 其中之一。
傳回碼值
0 (成功) 或 1 (失敗)
結果集
無
備註
如果指定的帳戶與指定的設定檔無關,便會傳回一則錯誤。
當指定了帳戶,但沒有指定設定檔時,這個預存程序會從所有設定檔中移除指定的帳戶。例如,如果您準備關閉現有的 SMTP 伺服器,請從所有設定檔中移除使用這個 SMTP 伺服器的帳戶,而不是從每個設定檔中移除每個帳戶。
當指定了設定檔,但沒有指定帳戶時,這個預存程序會從指定的設定檔中移除所有帳戶。例如,如果您在變更設定檔所用的 SMTP 伺服器,從設定檔中移除所有帳戶,再依照需要來加入新帳戶,可能會很方便。
預存程序 sysmail_delete_profileaccount_sp 在 msdb 資料庫中,擁有者是 dbo 結構描述。如果目前的資料庫不是 msdb,就必須利用三部分名稱來執行這個程序。
權限
這個程序的執行權限預設會授與系統管理員 (sysadmin) 固定伺服器角色的成員。
範例
下列範例會顯示從 AdventureWorks Administrator
設定檔移除 Audit Account
帳戶。
EXECUTE msdb.dbo.sysmail_delete_profileaccount_sp
@profile_name = 'AdventureWorks Administrator',
@account_name = 'Audit Account' ;
請參閱
參考
Database Mail 和 SQL Mail 預存程序 (Transact-SQL)
其他資源
Database Mail
選取組態工作 (Database Mail)
Database Mail 帳戶
Database Mail 設定檔