Set-SqlNetworkConfiguration

モジュール:: SqlServer

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 番目のコマンドは、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
配置:	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[]

SQLServer_Cmdlets