Set-SqlNetworkConfiguration
SQL Server のターゲット インスタンスのネットワーク構成を設定します。
構文
Set-SqlNetworkConfiguration
[-Protocol] <Protocols>
[[-Port] <Int32>]
[-Disable]
[-ForceServiceRestart]
[-NoServiceRestart]
[-Path <String[]>]
[-Credential] <PSCredential>
[-AutomaticallyAcceptUntrustedCertificates]
[-ManagementPublicPort <Int32>]
[-RetryTimeout <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-SqlNetworkConfiguration
[-Protocol] <Protocols>
[[-Port] <Int32>]
[-Disable]
[-ForceServiceRestart]
[-NoServiceRestart]
-InputObject <Server[]>
[-Credential] <PSCredential>
[-AutomaticallyAcceptUntrustedCertificates]
[-ManagementPublicPort <Int32>]
[-RetryTimeout <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-SqlNetworkConfiguration
[-Protocol] <Protocols>
[[-Port] <Int32>]
[-Disable]
[-ForceServiceRestart]
[-NoServiceRestart]
-ServerInstance <String[]>
[-Credential] <PSCredential>
[-AutomaticallyAcceptUntrustedCertificates]
[-ManagementPublicPort <Int32>]
[-RetryTimeout <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Set-SqlNetworkConfiguration コマンドレットは、SQL Serverのターゲット インスタンスのネットワーク構成を設定します。
SQL Server クラウド アダプターが、SQL Server のインスタンスをホストするコンピューターで実行され、アクセス可能である必要があります。
このコマンドレットでは、次の操作モードがサポートされています。
- Windows PowerShell パスのインスタンスを指定します。
- サーバー オブジェクトを指定します。
- SQL Serverのターゲット インスタンスの ServerInstance オブジェクトを指定します。
Note: This cmdlet ceased to work a long time ago. It's been removed in version 22 of the module.
例
例 1: ターゲット SQL Serverのネットワーク構成を設定する
PS C:\> CD SQLSERVER:\SQL\Computer\Instance
PS SQLSERVER:\SQL\Computer\Instance> Set-SqlNetworkConfiguration -Credential $credential -Protocol TCP -Port 1433 -NoServiceRestart -AcceptSelfSignedCertificate
最初のコマンドは、ディレクトリを . に SQLSERVER:\SQL\Computer\Instance
変更します。
2 番目のコマンドは、サーバー インスタンスのポート1433
で接続を受け入れるようにTCP
ネットワーク構成を設定しますComputer\Instance
。
現在の作業ディレクトリは、操作が発生するサーバー インスタンスを決定するために使用されます。
SQL Server サービスは自動的に再起動されません。
ターゲット コンピューターの自己署名証明書は、ユーザーに確認を求めずに自動的に受け入れられます。
例 2: パイプラインを使用してターゲット SQL Serverのネットワーク構成を設定する
PS C:\> Get-SqlInstance -Credential $Credential -MachineName "Computer006" | Set-SqlNetworkConfiguration -Credential $Credential -Protocol TCP -Disable -NoServiceRestart -AcceptSelfSignedCertificate;
このコマンドは、名前付きのComputer006
コンピューター上のSQL Serverのすべてのインスタンスを取得し、それらのそれぞれに対する接続を無効にしますTCP
。
SQL Server サービスは自動的に再起動されません。
ターゲット コンピューターの自己署名証明書は、ユーザーに確認を求めずに自動的に受け入れられます。
パラメーター
-AutomaticallyAcceptUntrustedCertificates
このコマンドレットが信頼されていない証明書を自動的に受け入れることを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Credential
ターゲット コンピューターで Windows 管理者の資格情報を持つユーザー アカウントを指定します。
型: | PSCredential |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Disable
このコマンドレットが、SQL Serverのターゲット インスタンスで指定されたネットワーク プロトコルを無効にすることを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ForceServiceRestart
このコマンドレットは、必要に応じて、ユーザーにメッセージを表示せずに、SQL Server サービスを強制的に再起動することを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InputObject
ターゲット インスタンスのサーバー オブジェクトの配列を指定します。
型: | Server[] |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ManagementPublicPort
ターゲット コンピューター上のパブリック管理ポートを指定します。 このパラメーターは、ターゲット コンピューターのポートに直接アクセスできないが、エンドポイントを介して公開されている場合に使用されます。 つまり、このコマンドレットは別のポートに接続する必要があります。
このポートから SQL Server クラウド アダプターにアクセスできる必要があります。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-NoServiceRestart
このコマンドレットは、ユーザーにメッセージを表示せずに、SQL Server サービスの再起動を防止することを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Path
このコマンドレットが操作を実行するSQL Serverのインスタンスへのパスを配列として指定します。 このパラメーターの値を指定しない場合、コマンドレットは現在の作業場所を使用します。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Port
TCP 接続を受け入れるポートを指定します。 動的ポートを構成するには、このパラメーターを 0 に設定します。
型: | Int32 |
配置: | 2 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Protocol
SQL Server のターゲット インスタンスで構成するネットワーク プロトコルを指定します。
型: | Protocols |
指定可能な値: | TCP |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | 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[]