Add-SqlFirewallRule

模組:

SQLServer

加入 Windows 防火牆規則，以允許特定 SQL Server 執行個體的連線。

語法

PowerShell

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

PowerShell

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

PowerShell

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

Description

Add-SqlFirewallRule Cmdlet 會新增 Windows 防火牆規則，以允許指定實例的連線SQL Server。 SQL Server Cloud Adapter 必須在裝載 SQL Server 實例的電腦上執行並存取。

這個 Cmdlet 支援下列作業模式：

• 指定實例Windows PowerShell路徑。
• 指定伺服器物件。
• 指定目標實例的伺服器實例SQL Server。

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

範例

範例 1：在本機電腦上新增 Windows 防火牆規則

PowerShell

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

第一個命令會將目錄變更為SQL Server電腦實例。

範例 2：透過管道在本機電腦上新增 Windows 防火牆規則

PowerShell

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

此命令會根據儲存在名為 $Credentials 變數中的認證，取得SQL Server實例。 然後，此命令會在名為 'Computer001' 的電腦上傳送SQL Server SQL Server實例。 命令接著會新增 Windows 防火牆規則，以允許每個實例的連線。 系統會自動接受目的機器的自我簽署憑證，而不會提示使用者。

參數

-AutomaticallyAcceptUntrustedCertificates

表示此 Cmdlet 會自動接受不受信任的憑證。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

在執行 Cmdlet 之前，會提示您確認。在執行 Cmdlet 之前，會提示您確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Credential

指定連線SQL Server的 PSCredential 物件。 若要取得認證物件，請使用 Get-Credential Cmdlet。 如需詳細資訊，請輸入 Get-Help Get-Credential。

類型:	PSCredential
Position:	0
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-InputObject

指定目標實例的伺服器物件SQL Server。

類型:	Server[]
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-ManagementPublicPort

指定目的電腦上的公用管理埠。 當目的電腦的埠無法直接存取，但會透過端點公開時使用此參數，這表示它們必須連線到不同的埠。

SQL Server Cloud Adapter 必須可透過此埠存取。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Path

指定此 Cmdlet 執行作業之SQL Server實例的路徑。 如果未指定此參數，此參數的值會預設為目前的工作位置。

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RetryTimeout

指定要在目標伺服器上重試命令的時間週期。 逾時到期之後，不會嘗試重試。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ServerInstance

指定SQL Server實例的名稱做為陣列，成為作業的目標。

類型:	String[]
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 Cmdlet 未執行。顯示 Cmdlet 執行時會發生什麼情況。 Cmdlet 並不會執行。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

Microsoft.SqlServer.Management.Smo.Server[]

System.String[]

輸出

System.Object

相關連結

• Remove-SqlFirewallRule