Set-SqlNetworkConfiguration

Modul:

SQLServer

Mengatur konfigurasi jaringan instans target SQL Server.

Sintaks

Set-SqlNetworkConfiguration
   [-Protocol] <Protocols>
   [[-Port] <Int32>]
   [-Disable]
   [-ForceServiceRestart]
   [-NoServiceRestart]
   [-Path <String[]>]
   [-Credential] <PSCredential>
   [-AutomaticallyAcceptUntrustedCertificates]
   [-ManagementPublicPort <Int32>]
   [-RetryTimeout <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-SqlNetworkConfiguration
   [-Protocol] <Protocols>
   [[-Port] <Int32>]
   [-Disable]
   [-ForceServiceRestart]
   [-NoServiceRestart]
   -InputObject <Server[]>
   [-Credential] <PSCredential>
   [-AutomaticallyAcceptUntrustedCertificates]
   [-ManagementPublicPort <Int32>]
   [-RetryTimeout <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-SqlNetworkConfiguration
   [-Protocol] <Protocols>
   [[-Port] <Int32>]
   [-Disable]
   [-ForceServiceRestart]
   [-NoServiceRestart]
   -ServerInstance <String[]>
   [-Credential] <PSCredential>
   [-AutomaticallyAcceptUntrustedCertificates]
   [-ManagementPublicPort <Int32>]
   [-RetryTimeout <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Deskripsi

Cmdlet Set-SqlNetworkConfiguration menetapkan konfigurasi jaringan instans target SQL Server.

SQL Server Cloud Adapter harus berjalan dan dapat diakses pada komputer yang menghosting instans SQL Server.

Cmdlet ini mendukung mode operasi berikut:

• Tentukan instans jalur Windows PowerShell.
• Tentukan objek server.
• Tentukan objek ServerInstance dari instans target SQL Server.

Note: This cmdlet ceased to work a long time ago. It's been removed in version 22 of the module.

Contoh

Contoh 1: Atur konfigurasi jaringan SQL Server target

PS C:\> CD SQLSERVER:\SQL\Computer\Instance
PS SQLSERVER:\SQL\Computer\Instance> Set-SqlNetworkConfiguration -Credential $credential -Protocol TCP -Port 1433 -NoServiceRestart -AcceptSelfSignedCertificate

Perintah pertama mengubah direktori menjadi SQLSERVER:\SQL\Computer\Instance. Perintah kedua mengatur konfigurasi jaringan untuk menerima TCP koneksi di port 1433 untuk instans server bernama Computer\Instance. Direktori kerja saat ini digunakan untuk menentukan instans server tempat operasi terjadi. Layanan SQL Server tidak dimulai ulang secara otomatis. Sertifikat yang ditandatangani sendiri dari komputer target secara otomatis diterima tanpa meminta pengguna.

Contoh 2: Mengatur konfigurasi jaringan SQL Server target menggunakan alur

PS C:\> Get-SqlInstance -Credential $Credential -MachineName "Computer006" | Set-SqlNetworkConfiguration -Credential $Credential -Protocol TCP -Disable -NoServiceRestart -AcceptSelfSignedCertificate;

Perintah ini mendapatkan semua instans SQL Server di komputer bernama Computer006 dan menonaktifkan koneksi untuk masing-masing instansTCP. Layanan SQL Server tidak dimulai ulang secara otomatis. Sertifikat yang ditandatangani sendiri dari komputer target secara otomatis diterima tanpa meminta pengguna.

Parameter

-AutomaticallyAcceptUntrustedCertificates

Menunjukkan bahwa cmdlet ini secara otomatis menerima sertifikat yang tidak tepercaya.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Jenis:	SwitchParameter
Alias:	cf
Position:	Named
Nilai default:	False
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Credential

Menentukan akun pengguna dengan kredensial Administrator Windows pada komputer target.

Jenis:	PSCredential
Position:	0
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-Disable

Menunjukkan bahwa cmdlet ini menonaktifkan protokol jaringan yang ditentukan pada instans target SQL Server.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-ForceServiceRestart

Menunjukkan bahwa cmdlet ini memaksa layanan SQL Server untuk memulai ulang, jika perlu, tanpa meminta pengguna.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-InputObject

Menentukan array objek server dari instans target.

Jenis:	Server[]
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	True
Terima karakter wildcard:	False

-ManagementPublicPort

Menentukan port manajemen publik pada komputer target. Parameter ini digunakan ketika port komputer target tidak dapat diakses secara langsung tetapi diekspos melalui titik akhir. Ini berarti bahwa cmdlet ini perlu terhubung ke port yang berbeda.

SQL Server Cloud Adapter harus dapat diakses oleh port ini.

Jenis:	Int32
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-NoServiceRestart

Menunjukkan bahwa cmdlet ini mencegah restart layanan SQL Server tanpa meminta pengguna.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Path

Menentukan jalur, sebagai array, ke instans SQL Server tempat cmdlet ini menjalankan operasi. Jika Anda tidak menentukan nilai untuk parameter ini, cmdlet menggunakan lokasi kerja saat ini.

Jenis:	String[]
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Port

Menentukan port untuk menerima koneksi TCP. Untuk mengonfigurasi port dinamis, parameter ini harus diatur ke nol.

Jenis:	Int32
Position:	2
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Protocol

Menentukan protokol jaringan yang ingin kami konfigurasi pada instans target SQL Server.

Jenis:	Protocols
Nilai yang diterima:	TCP
Position:	1
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-RetryTimeout

Menentukan periode waktu untuk mencoba kembali perintah pada server target. Setelah batas waktu berakhir, tidak ada percobaan ulang yang akan dicoba.

Jenis:	Int32
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-ServerInstance

Menentukan nama instans, sebagai array, dari SQL Server yang menjadi target operasi.

Jenis:	String[]
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	True
Terima karakter wildcard:	False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Jenis:	SwitchParameter
Alias:	wi
Position:	Named
Nilai default:	False
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

Input

Microsoft.SqlServer.Management.Smo.Server[]

System.String[]

Link Terkait

• SQLServer_Cmdlets