Add-SqlFirewallRule

Modul:

SQLServer

Menambahkan aturan Windows Firewall untuk memperbolehkan koneksi ke instans SQL Server tertentu.

Sintaks

Add-SqlFirewallRule
   [-Path <String[]>]
   [-Credential] <PSCredential>
   [-AutomaticallyAcceptUntrustedCertificates]
   [-ManagementPublicPort <Int32>]
   [-RetryTimeout <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-SqlFirewallRule
   -InputObject <Server[]>
   [-Credential] <PSCredential>
   [-AutomaticallyAcceptUntrustedCertificates]
   [-ManagementPublicPort <Int32>]
   [-RetryTimeout <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Add-SqlFirewallRule
   -ServerInstance <String[]>
   [-Credential] <PSCredential>
   [-AutomaticallyAcceptUntrustedCertificates]
   [-ManagementPublicPort <Int32>]
   [-RetryTimeout <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Deskripsi

Cmdlet Add-SqlFirewallRule menambahkan aturan Windows Firewall untuk memungkinkan koneksi untuk instans SQL Server yang ditentukan. Adaptor Cloud SQL Server harus berjalan dan dapat diakses di komputer yang menghosting instans SQL Server.

Cmdlet ini mendukung mode operasi berikut:

• Tentukan jalur Windows PowerShell instans.
• Tentukan objek server.
• Tentukan instans server 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: Menambahkan aturan Windows Firewall di komputer lokal

PS C:\> CD SQLSERVER:\SQL\Computer\Instance
PS SQLSERVER:\SQL\Computer\Instance> Add-SqlFirewallRule -Credential $Credential -AcceptSelfSignedCertificate

Perintah pertama mengubah direktori ke instans komputer SQL Server.

Contoh 2: Menambahkan aturan Windows Firewall di komputer lokal melalui pipa

PS C:\> Get-SqlInstance -Credential $Credential -MachineName "Computer001" | Add-SqlFirewallRule -Credential $Credential -AcceptSelfSignedCertificate

Perintah ini mendapatkan instans SQL Server berdasarkan kredensial yang disimpan dalam variabel bernama $Credentials. Perintah kemudian menyalurkan instans SQL Server SQL Server di komputer bernama 'Computer001'. Perintah kemudian menambahkan aturan Windows Firewall untuk memungkinkan koneksi untuk masing-masing instans. 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 konfirmasi sebelum menjalankan cmdlet. Meminta konfirmasi sebelum menjalankan cmdlet.

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

-Credential

Menentukan objek PSCredential untuk koneksi yang akan SQL Server. Untuk mendapatkan objek kredensial, gunakan cmdlet Get-Credential. Untuk informasi selengkapnya, ketik Get-Help Get-Credential.

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

-InputObject

Menentukan objek server dari instans target SQL Server.

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, yang berarti bahwa mereka perlu dihubungkan ke port yang berbeda.

Adaptor SQL Server Cloud harus dapat diakses oleh port ini.

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

-Path

Menentukan jalur ke instans SQL Server tempat cmdlet ini menjalankan operasi. Jika parameter ini tidak ditentukan, nilai parameter ini default ke lokasi kerja saat ini.

Jenis:	String[]
Position:	Named
Nilai default:	None
Diperlukan:	False
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 dicoba.

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

-ServerInstance

Menentukan nama instans SQL Server, sebagai array, 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. 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[]

Output

System.Object

Link Terkait

• Remove-SqlFirewallRule