Add-SqlFirewallRule
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
このコマンドレットが信頼されていない証明書を自動的に受け入れることを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。コマンドレットを実行する前に確認を求めるメッセージが表示されます。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Credential
SQL Serverへの接続の PSCredential オブジェクトを指定します。 資格情報オブジェクトを取得するには、Get-Credential コマンドレットを使用します。 詳細については、「Get-Help Get-Credential」と入力してください。
| 型: | 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