Add-SqlFirewallRule

リファレンス

モジュール:: SQLServer

SQL Server の特定のインスタンスへの接続を許可するように、Windows ファイアウォールルールを追加します。

構文

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>]

説明

Add-SqlFirewallRule コマンドレットは、指定したSQL Serverインスタンスの接続を許可する Windows ファイアウォール規則を追加します。 SQL Serverクラウドアダプターは、SQL Serverのインスタンスをホストするコンピューター上で実行され、アクセスできる必要があります。

このコマンドレットでは、次の操作モードがサポートされています。

インスタンス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 ファイアウォール規則を追加する

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

最初のコマンドは、SQL Server コンピューターインスタンスにディレクトリを変更します。

例 2: パイプを介してローカルコンピューターに Windows ファイアウォール規則を追加する

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

このコマンドは、$Credentials という名前の変数に格納されている資格情報に基づいて、SQL Server インスタンスを取得します。その後、コマンドは、'Computer001' という名前のコンピューター上のSQL ServerのSQL Server インスタンスをパイプします。次に、このコマンドは、インスタンスの 1 つごとに接続を許可する Windows ファイアウォール規則を追加します。ターゲットコンピューターの自己署名証明書は、ユーザーに確認を求めずに自動的に受け入れられます。

パラメーター

-AutomaticallyAcceptUntrustedCertificates

このコマンドレットが信頼されていない証明書を自動的に受け入れることを示します。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

コマンドレットを実行する前に確認を求めるメッセージが表示されます。コマンドレットを実行する前に確認を求めるメッセージが表示されます。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

SQL Serverへの接続の PSCredential オブジェクトを指定します。資格情報オブジェクトを取得するには、Get-Credential コマンドレットを使用します。詳細については、「Get-Help Get-Credential」と入力してください。

Type:	PSCredential
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

SQL Serverのターゲットインスタンスのサーバーオブジェクトを指定します。

Type:	Server[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ManagementPublicPort

ターゲットコンピューター上のパブリック管理ポートを指定します。このパラメーターは、ターゲットマシンのポートに直接アクセスできないが、エンドポイントを介して公開されている場合に使用されます。つまり、別のポートに接続する必要があります。

SQL Server クラウドアダプターには、このポートからアクセスできる必要があります。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

このコマンドレットが操作を実行するSQL Serverのインスタンスへのパスを指定します。このパラメーターが指定されていない場合、このパラメーターの値は既定で現在の作業場所になります。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RetryTimeout

ターゲットサーバーでコマンドを再試行する期間を指定します。タイムアウトが切れた後、再試行は試行されません。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServerInstance

操作のターゲットとなるSQL Serverのインスタンスの名前を配列として指定します。

Type:	String[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

コマンドレットの実行時に発生する内容を示します。コマンドレットが実行されていません。コマンドレットを実行した場合の動作を示します。このコマンドレットは実行されません。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

入力

Microsoft.SqlServer.Management.Smo.Server[]

System.String[]

出力

System.Object

Remove-SqlFirewallRule