Set-SqlNetworkConfiguration
SQL Server のターゲット インスタンスのネットワーク構成を設定します。
構文
ByPath (既定)
Set-SqlNetworkConfiguration
[-Protocol] <Protocols>
[[-Port] <Int32>]
[-Credential] <PSCredential>
[-Disable]
[-ForceServiceRestart]
[-NoServiceRestart]
[-Path <String[]>]
[-AutomaticallyAcceptUntrustedCertificates]
[-ManagementPublicPort <Int32>]
[-RetryTimeout <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Set-SqlNetworkConfiguration
[-Protocol] <Protocols>
[[-Port] <Int32>]
[-Credential] <PSCredential>
-InputObject <Server[]>
[-Disable]
[-ForceServiceRestart]
[-NoServiceRestart]
[-AutomaticallyAcceptUntrustedCertificates]
[-ManagementPublicPort <Int32>]
[-RetryTimeout <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByName
Set-SqlNetworkConfiguration
[-Protocol] <Protocols>
[[-Port] <Int32>]
[-Credential] <PSCredential>
-ServerInstance <String[]>
[-Disable]
[-ForceServiceRestart]
[-NoServiceRestart]
[-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 番目のコマンドは、TCP という名前のサーバー インスタンスのポート 1433で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
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
| 型: | SwitchParameter
|
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Credential
ターゲット コンピューター上の Windows 管理者の資格情報を持つユーザー アカウントを指定します。
パラメーターのプロパティ
| 型: | PSCredential
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Disable
このコマンドレットが、SQL Server のターゲット インスタンスで指定されたネットワーク プロトコルを無効にすることを示します。
パラメーターのプロパティ
| 型: | SwitchParameter
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ForceServiceRestart
このコマンドレットは、必要に応じて、ユーザーにメッセージを表示せずに SQL Server サービスを強制的に再起動することを示します。
パラメーターのプロパティ
| 型: | SwitchParameter
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
ターゲット インスタンスのサーバー オブジェクトの配列を指定します。
| 型: | Server[]
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
ByObject
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ManagementPublicPort
ターゲット コンピューターのパブリック管理ポートを指定します。
このパラメーターは、ターゲット コンピューターのポートに直接アクセスできないが、エンドポイントを介して公開されている場合に使用されます。
つまり、このコマンドレットは別のポートに接続する必要があります。
SQL Server クラウド アダプターには、このポートからアクセスできる必要があります。
パラメーターのプロパティ
| 型: | Int32
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-NoServiceRestart
このコマンドレットによって、ユーザーにメッセージを表示せずに SQL Server サービスを再起動できないようにすることを示します。
パラメーターのプロパティ
| 型: | SwitchParameter
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Path
このコマンドレットが操作を実行する SQL Server のインスタンスへのパスを配列として指定します。
このパラメーターの値を指定しない場合、コマンドレットは現在の作業場所を使用します。
パラメーターのプロパティ
| 型: | String[]
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ByPath
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Port
TCP 接続を受け入れるポートを指定します。
動的ポートを構成するには、このパラメーターを 0 に設定する必要があります。
パラメーターのプロパティ
| 型: | Int32
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 2 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Protocol
SQL Server のターゲット インスタンスで構成するネットワーク プロトコルを指定します。
パラメーターのプロパティ
| 型: | Protocols
|
| 規定値: | None |
| 指定可能な値: | TCP |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-RetryTimeout
ターゲット サーバーでコマンドを再試行する期間を指定します。
タイムアウトが切れると、再試行は行われません。
パラメーターのプロパティ
| 型: | Int32
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ServerInstance
操作のターゲットとなる SQL Server のインスタンスの名前を配列として指定します。
パラメーターのプロパティ
| 型: | String[]
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ByName
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
パラメーターのプロパティ
| 型: | SwitchParameter
|
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
Microsoft.SqlServer.Management.Smo.Server
System.String