Condividi tramite


sp_update_proxy (Transact-SQL)

Modifica le proprietà di un proxy già esistente.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

sp_update_proxy 
    [ @proxy_id = ] id,
    [ @proxy_name = ] 'proxy_name',
    [ @credential_name = ] 'credential_name' ,
    [ @credential_id = ] credential_id ,
    [ @new_name = ] 'new_name' ,
    [ @enabled = ] is_enabled ,
    [ @description = ] 'description'

Argomenti

  • [ @proxy_id= ] id
    Numero di identificazione del proxy da modificare. proxy_id è di tipo int e il valore predefinito è NULL.

  • [ @proxy_name= ] 'proxy_name'
    Nome del proxy da modificare. proxy_name è di tipo sysname e il valore predefinito è NULL.

  • [ @credential_name = ] 'credential_name'
    Nome delle nuove credenziali per il proxy. credential_name è di tipo sysname e il valore predefinito è NULL. È possibile specificare l'argomento credential_name o l'argomento credential_id.

  • [ @credential_id = ] credential_id
    Numero di identificazione delle nuove credenziali per il proxy. credential_id è di tipo int e il valore predefinito è NULL. È possibile specificare l'argomento credential_name o l'argomento credential_id.

  • [ @new_name= ] 'new_name'
    Nuove nome del proxy. new_name è di tipo sysname e il valore predefinito è NULL. Quando specificato, la procedura modifica il nome del proxy in new_name. Quando questo argomento è NULL, il nome del proxy rimane invariato.

  • [ @enabled = ] is_enabled
    Specifica se il proxy è attivato. Il flag is_enabled è di tipo tinyint e il valore predefinito è NULL. Quando is_enabled è 0 il proxy non è attivato e non può essere utilizzato da un passaggio di processo. Quando questo argomento è NULL, lo stato del proxy rimane invariato.

  • [ @description= ] 'description'
    Nuova descrizione del proxy. description è di tipo nvarchar(512) e il valore predefinito è NULL. Quando questo argomento è NULL, la descrizione del proxy rimane invariata.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Osservazioni

È necessario specificare l'argomento @proxy_name oppure l'argomento @proxy_id. Se si specificano entrambi gli argomenti, devono riferirsi tutti e due allo stesso proxy per consentire la corretta esecuzione della stored procedure.

È necessario specificare l'argomento @credential_name oppure l'argomento @credential_id per modificare le credenziali per il proxy. Se si specificano entrambi gli argomenti, devono riferirsi alle stesse credenziali per consentire la corretta esecuzione della stored procedure.

Questa procedura modifica il proxy, ma non modifica l'accesso al proxy. Per modificare l'accesso a un proxy, utilizzare sp_grant_login_to_proxy e sp_revoke_login_from_proxy.

Autorizzazioni

Solo i membri del ruolo di protezione predefinito sysadmin possono eseguire questa procedura.

Esempi

Nell'esempio seguente viene impostato il valore attivato per il proxy Catalog application proxy su 0.

USE msdb ;
GO

EXEC dbo.sp_update_proxy
    @proxy_name = 'Catalog application proxy',
    @enabled = 0;
GO