sp_help_proxy (Transact-SQL)

適用於:SQL Server

列出一或多個 Proxy 的資訊。

Transact-SQL 語法慣例

語法

sp_help_proxy
    [ [ @proxy_id = ] proxy_id ]
    [ , [ @proxy_name = ] N'proxy_name' ]
    [ , [ @subsystem_name = ] N'subsystem_name' ]
    [ , [ @name = ] N'name' ]
[ ; ]

引數

[ @proxy_id = ] proxy_id

要列出資訊的 Proxy 識別碼。 @proxy_id為 int,預設值為 NULL可以指定@proxy_id@proxy_name

[ @proxy_name = ] N'proxy_name'

要列出資訊的 Proxy 名稱。 @proxy_name為 sysname,預設值為 NULL可以指定@proxy_id@proxy_name

[ @subsystem_name = ] N'subsystem_name'

要列出 Proxy 的子系統名稱。 @subsystem_name為 sysname,預設值為 NULL。 指定@subsystem_name也必須指定@name

下表列出每個子系統的值。

Description
ActiveScripting ActiveX 腳本
CmdExec 作業系統 (CmdExec)
Snapshot Replication Snapshot Agent
LogReader 複寫記錄讀取器代理程式
Distribution Replication Distribution Agent
Merge Replication Merge Agent
QueueReader 複寫佇列讀取器代理程式
ANALYSISQUERY Analysis Services 命令
ANALYSISCOMMAND Analysis Services 查詢
Dts SSIS 封裝執行
PowerShell PowerShell 指令碼

[ @name = ] N'name'

要列出 Proxy 的 SQL Server 登入名稱。 @name為 nvarchar(256),預設值為 NULL。 指定@name也必須指定@subsystem_name

傳回碼值

0 (成功) 或 1 (失敗)。

結果集

資料行名稱 資料類型 描述
proxy_id int Proxy 識別碼。
name sysname Proxy 的名稱。
credential_identity sysname 與 Proxy 相關聯之認證的 Microsoft Windows 功能變數名稱和用戶名稱。
enabled tinyint 是否啟用此 Proxy。 0 = 未啟用, 1 = 已啟用。
description nvarchar(1024) 此 Proxy 的描述。
user_sid varbinary(85) 此 Proxy 之 Windows 使用者的 Windows 安全性識別碼。
credential_id int 與此 Proxy 相關聯的認證標識碼。
credential_identity_exists int credential_identity是否存在。 0 = 不存在, 1 = 存在。

備註

如果未提供任何參數, sp_help_proxy 請列出 實例中所有 Proxy 的資訊。

若要判斷登入可用於指定子系統的 Proxy,請指定 @name@subsystem_name。 提供這些自變數時, sp_help_proxy 列出指定的登入可能會存取的 Proxy,以及可能用於指定子系統的 Proxy。

權限

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

其他用戶必須在資料庫中獲得下列其中一個 SQL Server Agent 固定資料庫角色 msdb

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

如需這些角色權限的詳細資訊,請參閱 SQL Server Agent 固定資料庫角色

credential_identity只有在 sysadmin 的成員執行這個預存程式時,才會在結果集中傳回 和 user_sid 數據行。

範例

A. 列出所有 Proxy 的資訊

下列範例會列出 實例中所有 Proxy 的資訊。

USE msdb;
GO

EXEC dbo.sp_help_proxy;
GO

B. 列出特定 Proxy 的資訊

下列範例會列出名為 Catalog application proxy的 Proxy 資訊。

USE msdb;
GO

EXEC dbo.sp_help_proxy
    @proxy_name = N'Catalog application proxy';
GO