sysmail_delete_profileaccount_sp (Transact-SQL)

  • 發行項

從 Database Mail 設定檔中移除帳戶。

主題連結圖示 Transact-SQL 語法慣例

語法

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 預存程序 (Transact-SQL)

概念

Database Mail

建立 Database Mail 帳戶

Database Mail 組態物件