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 インスタンスをパイプします。次に、このコマンドは、インスタンスごとに接続を許可する Windows ファイアウォール規則を追加します。ターゲットコンピューターの自己署名証明書は、ユーザーにメッセージを表示せずに自動的に受け入れられます。

パラメーター

-AutomaticallyAcceptUntrustedCertificates

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

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

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

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Credential

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

型:	PSCredential
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-InputObject

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

型:	Server[]
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-ManagementPublicPort

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

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

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Path

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

型:	String[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RetryTimeout

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

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ServerInstance

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

型:	String[]
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットを実行した場合の動作を示します。コマンドレットは実行されません。コマンドレットを実行した場合の動作を示します。コマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

Microsoft.SqlServer.Management.Smo.Server[]

System.String[]

出力

System.Object

Remove-SqlFirewallRule