次の方法で共有

Set-SqlAvailabilityGroupListener

  • リファレンス
モジュール:
SQLPS

可用性グループ リスナーのポート設定を設定します。

構文

Set-SqlAvailabilityGroupListener
   [-Port <Int32>]
   [[-Path] <String>]
   [-Script]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SqlAvailabilityGroupListener
   [-Port <Int32>]
   [-InputObject] <AvailabilityGroupListener>
   [-Script]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Set-SqlAvailabilityGroupListener コマンドレットは、既存の可用性グループ リスナーのポート設定を変更します。 プライマリ レプリカをホストするサーバー インスタンスでこのコマンドレットを実行します。

例

例 1: 可用性グループのリスナーを変更する

PS C:\> Set-SqlAvailabilityGroupListener -Port 1535 -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityGroupListeners\MainListener"

このコマンドは、MainListener という名前の可用性グループ リスナーのポート番号を 1535 に設定します。 このポートは、リスナーへの接続をリッスンするために使用されます。

例 2: リスナーを変更するスクリプトを作成する

PS C:\> Set-SqlAvailabilityGroupListener -Port 1535 -Script -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityGroupListeners\MainListener"

このコマンドは、MainListener という名前の可用性グループ リスナーのポート番号を 1535 に設定する Transact-SQL スクリプトを生成します。 このコマンドでは、その変更は行われません。

パラメーター

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InputObject

このコマンドレットが変更するリスナーを AvailabilityGroupListener オブジェクトとして指定します。

型:AvailabilityGroupListener
配置:2
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Path

このコマンドレットによって変更される可用性グループ リスナーのパスを指定します。 このパラメーターを指定しない場合、このコマンドレットは現在の作業場所を使用します。

型:String
配置:2
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Port

リスナーが接続をリッスンするポートを指定します。 既定のポートは TCP ポート 1433 です。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Script

このコマンドレットによって、このコマンドレットが実行するタスクを実行する Transact-SQL スクリプトが返されることを示します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

Microsoft.SqlServer.Management.Smo.AvailabilityGroupListener