次の方法で共有


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 という名前のサーバー インスタンスのポート 1433Computer\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

-InputObject

ターゲット インスタンスのサーバー オブジェクトの配列を指定します。

パラメーターのプロパティ

型:

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