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
このコマンドレットが信頼されていない証明書を自動的に受け入れることを示します。
| 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
ターゲット コンピューターで Windows 管理者の資格情報を持つユーザー アカウントを指定します。
| Type: | PSCredential |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Disable
このコマンドレットが、SQL Serverのターゲット インスタンスで指定されたネットワーク プロトコルを無効にすることを示します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceServiceRestart
このコマンドレットは、必要に応じて、ユーザーにメッセージを表示せずに、SQL Server サービスを強制的に再起動することを示します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
ターゲット インスタンスのサーバー オブジェクトの配列を指定します。
| 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 |
-NoServiceRestart
このコマンドレットは、ユーザーにメッセージを表示せずに、SQL Server サービスの再起動を防止することを示します。
| Type: | SwitchParameter |
| 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 |
-Port
TCP 接続を受け入れるポートを指定します。 動的ポートを構成するには、このパラメーターを 0 に設定します。
| Type: | Int32 |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Protocol
SQL Server のターゲット インスタンスで構成するネットワーク プロトコルを指定します。
| Type: | Protocols |
| Accepted values: | TCP |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| 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[]