sp_help_proxy (Transact-SQL)

Aplica-se a:SQL Server

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

Convenções de sintaxe de 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. A ID ou a proxy_name podem ser especificadas.

[ @proxy_name = ] 'proxy_name' O nome do proxy para o qual listar informações. O proxy_name é sysname, com um padrão de NULL. A ID ou a proxy_name podem ser especificadas.

[ @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 é especificado, o nome também deve ser especificado.

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

Valor	Descrição
ActiveScripting	Script do ActiveX
CmdExec	Sistema Operacional (CmdExec)
Instantâneo	Replication Snapshot Agent
LogReader	Replication Agente de Leitor de Log
Distribuição	Agente de Distribuição de Replicação
Mesclar	Replication Merge Agent
QueueReader	Agente de Leitor de Fila de Replicação
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 logon SQL Server para o qual listar proxies. O nome é nvarchar(256), com um padrão NULL. Quando o nome é especificado, subsystem_name também deve ser especificado.

Valores do 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.
name	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	Se esse proxy está habilitado. { 0 = não habilitado, 1 = habilitado }
descrição	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 logon pode usar para um determinado subsistema, especifique name e subsystem_name. Quando esses argumentos são fornecidos, sp_help_proxy lista proxies que o logon 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 SQL Server Agent Funções de banco de dados fixas.

Observação

As colunas credential_identity e user_sid são retornadas somente no conjunto de resultados quando 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

Procedimentos armazenados do SQL Server Agent (Transact-SQL)
sp_add_proxy (Transact-SQL)
sp_delete_proxy (Transact-SQL)