Compartir a través de


sp_help_proxy (Transact-SQL)

Muestra información de uno o varios servidores proxy.

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

  • [ @proxy_id = ] id
    Número de identificación del proxy del que se muestra información. proxy_id es de tipo int y su valor predeterminado es NULL. Puede especificarse id o proxy_name.

  • [ @proxy_name = ] 'proxy_name'
    Nombre del proxy del que se va a mostrar información. proxy_name es de tipo sysname y su valor predeterminado es NULL. Puede especificarse id o proxy_name.

  • [ @subsystem_name = ] 'subsystem_name'
    Nombre del subsistema del que se van a mostrar los servidores proxy. subsystem_name es de tipo sysname y su valor predeterminado es NULL. Si se especifica subsystem_name, se debe especificar también name.

    En la siguiente tabla se enumeran los valores disponibles para cada subsistema.

    Valor

    Descripción

    ActiveScripting

    Script ActiveX

    CmdExec

    Sistema operativo (CmdExec)

    Snapshot

    Agente de instantáneas de replicación

    LogReader

    Agente de registro del LOG de replicación

    Distribution

    Agente de distribución de replicación

    Merge

    Agente de mezcla de replicación

    QueueReader

    Agente de lectura de cola de replicación

    ANALYSISQUERY

    Comando de Analysis Services

    ANALYSISCOMMAND

    Consulta de Analysis Services

    Dts

    Ejecución de paquetes SSIS

    PowerShell

    Script de PowerShell

  • [ [ @name = ] 'name'
    Nombre del inicio de sesión de SQL Server del que se van a mostrar los servidores proxy. El nombre es de tipo nvarchar(256) y su valor predeterminado es NULL. Si se especifica name, se debe especificar también subsystem_name.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

Nombre de columna

Tipo de datos

Descripción

proxy_id

int

Número de identificación del proxy.

name

sysname

Nombre del proxy.

credential_identity

sysname

Nombre de dominio y nombre de usuario de Microsoft Windows para la credencial asociada con el proxy.

enabled

tinyint

Si el proxy está habilitado. { 0 = no habilitado, 1 = habilitado }

description

nvarchar(1024)

Descripción de este proxy.

user_sid

varbinary(85)

Id. de seguridad del usuario de Windows para este proxy.

credential_id

int

Identificador de la credencial asociada con este proxy.

credential_identity_exists

int

Si existe credential_identity. { 0 = no existe, 1 = existe }

Comentarios

Si no se proporcionan parámetros, sp_help_proxy muestra información de todos los servidores proxy de la instancia.

Para determinar los servidores proxy que puede utilizar un inicio de sesión para un subsistema dado, especifique name y subsystem_name. Cuando se proporcionan estos argumentos, sp_help_proxy muestra los servidores proxy a los que puede tener acceso el inicio de sesión especificado y que se pueden utilizar para el subsistema especificado.

Permisos

De forma predeterminada, los miembros de la función fija de servidor sysadmin pueden ejecutar este procedimiento almacenado. A otros usuarios debe concederse la función fija de base de datos SQLAgentOperatorRole en la base de datos msdb.

Para obtener información detallada acerca de SQLAgentOperatorRole, vea Funciones fijas de base de datos del Agente SQL Server.

Nota

Las columnas credential_identity y user_sid sólo se devuelven en el conjunto de resultados cuando los miembros de la función sysadmin ejecutan este procedimiento almacenado.

Ejemplos

A. Mostrar información de todos los servidores proxy

El ejemplo siguiente muestra información de todos los servidores proxy de la instancia.

USE msdb ;
GO

EXEC dbo.sp_help_proxy ;
GO

B. Mostrar información de un proxy específico

El ejemplo siguiente muestra información del proxy denominado Catalog application proxy.

USE msdb ;
GO

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