Freigeben über

  • Artikel

sp_help_proxy (Transact-SQL)

Listet Informationen zu mindestens einem Proxy auf.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

  • [ @proxy_id = ] id
    Die Proxy-ID des Proxys, zu dem die Informationen aufgelistet werden sollen. proxy_id ist ein Wert vom Datentyp int. Der Standardwert ist NULL. Es kann entweder id oder proxy_name angegeben werden.

  • [ @proxy_name = ] 'proxy_name'
    Der Name des Proxys, zu dem Informationen aufgelistet werden sollen. proxy_name ist ein Wert vom Datentyp sysname. Der Standardwert ist NULL. Es kann entweder id oder proxy_name angegeben werden.

  • [ @subsystem_name = ] 'subsystem_name'
    Der Name des Subsystems, für den Proxys aufgelistet werden sollen. subsystem_name ist ein Wert vom Datentyp sysname. Der Standardwert ist NULL. Wenn subsystem_name angegeben ist, muss auch name angegeben sein.

    In der folgenden Tabelle werden die Werte für jedes Subsystem aufgelistet.

    Wert

    Beschreibung

    ActiveScripting

    ActiveX-Skript

    CmdExec

    Betriebssystem (CmdExec)

    Snapshot

    Replikationssnapshot-Agent

    LogReader

    Replikationsprotokolllese-Agent

    Distribution

    Replikationsverteilungs-Agent

    Merge

    Replikationsmerge-Agent

    QueueReader

    Warteschlangenlese-Agent der Microsoft SQL Server-Replikation

    ANALYSISQUERY

    Analysis Services-Befehl

    ANALYSISCOMMAND

    Analysis Services-Abfrage

    Dts

    SSIS-Paketausführung

    PowerShell

    PowerShell-Skript

  • [ [ @name = ] 'name'
    Der Name einer SQL Server-Anmeldung, für die Proxys aufgelistet werden sollen. Der Name ist vom Datentyp nvarchar(256) und hat den Standardwert NULL. Wenn name angegeben ist, muss auch subsystem_name angegeben sein.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Spaltenname

Datentyp

Beschreibung

proxy_id

int

Identifikationsnummer des Proxys.

name

sysname

Der Name des Proxys.

credential_identity

sysname

Der Microsoft Windows-Domänenname und -Benutzername für die dem Proxy zugeordneten Anmeldeinformationen.

enabled

tinyint

Gibt an, ob der Proxy aktiviert ist. { 0 = nicht aktiviert, 1 = aktiviert }

description

nvarchar(1024)

Die Beschreibung des Proxys.

user_sid

varbinary(85)

Die Windows-SID des Windows-Benutzers für diesen Proxy.

credential_id

int

Die ID für die dem Proxy zugeordneten Anmeldeinformationen.

credential_identity_exists

int

Gibt an, ob credential_identity vorhanden ist. { 0 = ist nicht vorhanden, 1 = ist vorhanden }

Hinweise

Wenn keine Parameter bereitgestellt sind, listet sp_help_proxy Informationen zu allen Proxys in der Instanz auf.

Sie können bestimmen, welche Proxys eine Anmeldung für ein bestimmtes Subsystem verwenden kann, indem Sie name und subsystem_name angeben. Bei Bereitstellung dieser Argumente werden von sp_help_proxy die Proxys aufgelistet, auf die der angegebene Anmeldename zugreifen kann und die für das angegebene Subsystem verwendet werden können.

Berechtigungen

Standardmäßig können nur Mitglieder der festen Serverrolle sysadmin diese gespeicherte Prozedur ausführen. Andere Benutzer müssen Mitglieder der festen Datenbankrolle SQLAgentOperatorRole in der msdb-Datenbank sein.

Ausführliche Informationen zu SQLAgentOperatorRole finden Sie unter Feste Datenbankrollen des SQL Server-Agents.

HinweisHinweis

Die Spalten credential_identity und user_sid werden im Resultset nur zurückgegeben, wenn die gespeicherte Prozedur von Mitgliedern der sysadmin-Rolle ausgeführt wird.

Beispiele

A. Auflisten der Informationen zu allen Proxys

Im folgenden Beispiel werden die Informationen zu allen Proxys in der Instanz aufgelistet.

USE msdb ;
GO

EXEC dbo.sp_help_proxy ;
GO

B. Auflisten der Informationen zu einem bestimmten Proxy

Im folgenden Beispiel werden die Informationen zum Proxy Catalog application proxy aufgelistet.

USE msdb ;
GO

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