sp_update_proxy (T-SQL)

  • Artikel

Berlaku untuk:SQL Server

Mengubah properti proksi yang ada.

Konvensi sintaks transact-SQL

Sintaks

sp_update_proxy
    [ [ @proxy_id = ] proxy_id ]
    [ , [ @proxy_name = ] N'proxy_name' ]
    [ , [ @credential_name = ] N'credential_name' ]
    [ , [ @credential_id = ] credential_id ]
    [ , [ @new_name = ] N'new_name' ]
    [ , [ @enabled = ] enabled ]
    [ , [ @description = ] N'description' ]
[ ; ]

Argumen

[ @proxy_id = ] proxy_id

Nomor identifikasi proksi proksi yang akan diubah. @proxy_id int, dengan default NULL.

[ @proxy_name = ] N'proxy_name'

Nama proksi yang akan diubah. @proxy_name adalah sysname, dengan default NULL.

[ @credential_name = ] N'credential_name'

Nama kredensial baru untuk proksi. @credential_name adalah sysname, dengan default NULL. Baik @credential_name atau @credential_id harus ditentukan.

[ @credential_id = ] credential_id

Nomor identifikasi kredensial baru untuk proksi. @credential_id int, dengan default NULL. Baik @credential_name atau @credential_id harus ditentukan.

[ @new_name = ] N'new_name'

Nama baru proksi. @new_name adalah sysname, dengan default NULL. Ketika disediakan, prosedur mengubah nama proksi menjadi @new_name. Ketika argumen ini adalah NULL, nama proksi tetap tidak berubah.

[ @enabled = ] diaktifkan

Menentukan apakah proksi diaktifkan. @enabled kecil, dengan default NULL. Saat @enabled adalah 0, proksi tidak diaktifkan, dan tidak dapat digunakan oleh langkah pekerjaan. Ketika argumen ini adalah NULL, status proksi tetap tidak berubah.

[ @description = ] N'description'

Deskripsi baru proksi. @description adalah nvarchar(512), dengan default NULL. Ketika argumen ini adalah NULL, deskripsi proksi tetap tidak berubah.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Keterangan

Baik @proxy_name atau @proxy_id harus ditentukan. Jika kedua argumen ditentukan, argumen harus merujuk ke proksi yang sama atau prosedur tersimpan gagal.

Baik @credential_name atau @credential_id harus ditentukan untuk mengubah kredensial untuk proksi. Jika kedua argumen ditentukan, argumen harus merujuk ke kredensial yang sama atau prosedur tersimpan gagal.

Prosedur ini mengubah proksi, tetapi tidak mengubah akses ke proksi. Untuk mengubah akses ke proksi, gunakan sp_grant_login_to_proxy dan sp_revoke_login_from_proxy.

Izin

Hanya anggota peran keamanan tetap sysadmin yang dapat menjalankan prosedur ini.

Contoh

Contoh berikut menetapkan nilai yang diaktifkan untuk proksi Catalog application proxy ke 0.

USE msdb;
GO

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

Konten terkait