sp_help_proxy (Transact-SQL)

Artigo
06/18/2013

Lista as informações para um ou mais proxies.

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

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

Argumentos

[ @proxy_id = ] id
O número de identificação de proxy do proxy para o qual listar informações. O proxy_id é int, com um padrão de NULL. Pode ser especificado id ou proxy_name.
[ @proxy_name = ] 'proxy_name'
O nome do proxy para o qual listar informações. O proxy_name é sysname, com um padrão de NULL. Pode ser especificado id ou proxy_name.

[ @subsystem_name = ] 'subsystem_name'
O nome do subsistema para o qual listar proxies. O subsystem_name é sysname, com um padrão de NULL. Quando subsystem_name for especificado, name também deverá ser especificado.

A tabela a seguir lista os valores padrão para cada subsistema.

Value	Descrição
ActiveScripting	Script do ActiveX
CmdExec	Sistema Operacional (CmdExec)
Instantâneo	Replication Snapshot Agent
LogReader	Replication Log Reader Agent
Distribuição	Replication Distribution Agent
Merge	Replication Merge Agent
QueueReader	Replication Queue Reader Agent
ANALYSISQUERY	Comando do Analysis Services
ANALYSISCOMMAND	Consulta do Analysis Services
Dts	Execução do pacote SSIS
PowerShell	Scripts PowerShell

[ @name = ] 'name'
O nome de um login do SQL Server para o qual listar proxies. O nome é nvarchar(256), com um padrão de NULL. Quando name for especificado, subsystem_name também deverá ser especificado.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Nome da coluna	Tipo de dados	Descrição
proxy_id	int	Número de identificação de proxy.
nome	sysname	O nome do proxy.
credential_identity	sysname	O nome de domínio de Microsoft Windows e o nome de usuário para a credencial associada ao proxy.
habilitado	tinyint	Especifica se o proxy está habilitado. { 0 = não habilitado, 1 = habilitado }
description	nvarchar(1024)	A descrição para esse proxy.
user_sid	varbinary(85)	A identificação de segurança do Windows do usuário do Windows para esse proxy.
credential_id	int	O identificador para a credencial associada a esse proxy.
credential_identity_exists	int	Especifica se credential_identity existe. {0 = não existe, 1 = existe}

Comentários

Quando nenhum parâmetro é fornecido, sp_help_proxy lista informações para todos os proxies na instância.

Para determinar quais proxies um login pode usar em um determinado subsistema, especifique name e subsystem_name. Quando esses argumentos são fornecidos, sp_help_proxy lista os proxies que o login especificado pode acessar e que podem ser usados para o subsistema especificado.

Permissões

Por padrão, os membros da função de servidor fixa sysadmin podem executar este procedimento armazenado. Deve ser concedida a outros usuários a função de banco de dados fixa SQLAgentOperatorRole no banco de dados msdb.

Para obter detalhes sobre SQLAgentOperatorRole, consulte Funções de banco de dados fixas do SQL Server Agent.

Observação
As colunas credential_identity e user_sid são retornadas apenas no conjunto de resultados quando os membros de sysadmin executam esse procedimento armazenado.

Exemplos

A.Listando informações para todos os proxies

O exemplo a seguir lista as informações para todos os proxies na instância.

USE msdb ;
GO

EXEC dbo.sp_help_proxy ;
GO

B.Listando informações para um proxy específico

O exemplo a seguir lista as informações para o proxy chamado Catalog application proxy.

USE msdb ;
GO

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

Consulte também

Referência

Procedimentos armazenados do SQL Server Agent (Transact-SQL)

sp_add_proxy (Transact-SQL)

sp_delete_proxy (Transact-SQL)

Partilhar via