sp_help_proxy (Transact-SQL)

列出一或多個 Proxy 的資訊。

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

語法

sp_help_proxy 
    [ @proxy_id = ] id,
    [ @proxy_name = ] 'proxy_name' ,
    [ @subsystem_name = ] 'subsystem_name' ,
    [ @name = ] 'name'

引數

  • [ @proxy_id = ] id
    要列出資訊的 Proxy 之 Proxy 識別碼。 proxy_id 是 int,預設值是 NULL。 您只能指定 id 或 proxy_name 其中之一。

  • [ @proxy_name = ] 'proxy_name'
    要列出資訊的 Proxy 名稱。 proxy_name 是 sysname,預設值是 NULL。 您只能指定 id 或 proxy_name 其中之一。

  • [ @subsystem_name = ] 'subsystem_name'
    要列出 Proxy 的子系統名稱。 subsystem_name 是 sysname,預設值是 NULL。 當指定 subsystem_name 時,也必須指定 name。

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

    值

    說明

    ActiveScripting

    ActiveX Script

    CmdExec

    作業系統 (CmdExec)

    Snapshot

    複寫快照集代理程式

    LogReader

    複寫記錄讀取器代理程式

    Distribution

    複寫散發代理程式

    Merge

    複寫合併代理程式

    QueueReader

    複寫佇列讀取器代理程式

    ANALYSISQUERY

    Analysis Services 命令

    ANALYSISCOMMAND

    Analysis Services 查詢

    Dts

    SSIS 封裝執行

    PowerShell

    PowerShell 指令碼

  • [ @name = ] 'name'
    要列出 Proxy 的 SQL Server 登入名稱。 這個名稱是 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 = not enabled, 1 = enabled }

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。

權限

依預設,只有系統管理員 (sysadmin) 固定伺服器角色的成員,才能夠執行這個預存程序。 其他使用者必須被授與 msdb 資料庫的 SQLAgentOperatorRole 固定資料庫角色。

如需有關 SQLAgentOperatorRole 的詳細資料,請參閱<SQL Server Agent 固定資料庫角色>。

[!附註]

當系統管理員 (sysadmin) 的成員執行此預設程序時,在結果集內只傳回 credential_identity 和 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

請參閱

參考

SQL Server Agent 預存程序 (Transact-SQL)

sp_add_proxy (Transact-SQL)

sp_delete_proxy (Transact-SQL)