Compartir vía


sp_help_proxy (Transact-SQL)

Se aplica a: SQL Server

Muestra información de uno o varios servidores proxy.

Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

[ @proxy_id = ] proxy_id

Número de identificación del proxy del que se muestra información. @proxy_id es int, con un valor predeterminado de NULL. Se puede especificar el @proxy_id o el @proxy_name .

[ @proxy_name = ] N'proxy_name'

Nombre del proxy del que se va a mostrar información. @proxy_name es sysname, con un valor predeterminado de NULL. Se puede especificar el @proxy_id o el @proxy_name .

[ @subsystem_name = ] N'subsystem_name'

Nombre del subsistema del que se van a mostrar los servidores proxy. @subsystem_name es sysname, con un valor predeterminado de NULL. Cuando se especifica @subsystem_name , también se debe especificar @name .

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

Valor Descripción
ActiveScripting Script ActiveX
CmdExec Sistema operativo (CmdExec)
Snapshot Replication Snapshot Agent
LogReader Agente de registro del LOG de replicación
Distribution Replication Distribution Agent
Merge Replication Merge Agent
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 = ] N'name'

Nombre de un inicio de sesión de SQL Server para el que se enumeran los servidores proxy. @name es nvarchar(256), con un valor predeterminado de NULL. Cuando se especifica @name , también se debe especificar @subsystem_name .

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Conjunto de resultados

Nombre de la 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 Especifica si este proxy está habilitado. 0 = no habilitado, 1 = habilitado.
description nvarchar(1024) Descripción de este proxy.
user_sid varbinary(85) Identificador de seguridad de Windows del usuario de Windows para este proxy.
credential_id int Identificador de la credencial asociada con este proxy.
credential_identity_exists int Especifica si credential_identity existe . 0 = no existe, 1 = existe.

Comentarios

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

Para determinar qué servidores proxy puede usar un inicio de sesión para un subsistema determinado, especifique @name y @subsystem_name. Cuando se proporcionan estos argumentos, sp_help_proxy se enumeran los servidores proxy a los que puede tener acceso el inicio de sesión especificado y que se pueden usar para el subsistema especificado.

Permisos

Este procedimiento almacenado es propiedad del rol db_owner . Puede conceder EXECUTE permisos para cualquier usuario, pero estos permisos se pueden invalidar durante una actualización de SQL Server.

A otros usuarios se les debe conceder uno de los siguientes Agente SQL Server roles fijos de base de datos en la msdb base de datos:

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

Para detalles sobre los permisos de estos roles, consulte Roles fijos de base de datos del Agente SQL Server.

Las credential_identity columnas y user_sid solo se devuelven en el conjunto de resultados cuando los miembros de sysadmin ejecutan este procedimiento almacenado.

Ejemplos

A Información de lista para 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. Enumeración de la 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