Share via

sysmail_delete_profileaccount_sp (Transact-SQL)

  • 發行項

適用於：SQL Server

從 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，則必須使用三部分名稱執行程式。

權限

此預存程式是由 db_owner 角色所擁有。 您可以授與 EXECUTE 任何用戶的許可權，但這些許可權可能會在 SQL Server 升級期間覆寫。

範例

下列範例顯示從配置檔AdventureWorks Administrator中移除帳戶Audit Account。

EXEC msdb.dbo.sysmail_delete_profileaccount_sp
    @profile_name = 'AdventureWorks Administrator',
    @account_name = 'Audit Account';

相關內容