Set-SqlAvailabilityGroupListener
可用性グループ リスナーのポート設定を設定します。
構文
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
コマンドレットの実行前に確認を求めるメッセージが表示されます。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
このコマンドレットが変更するリスナーを AvailabilityGroupListener オブジェクトとして指定します。
Type: | AvailabilityGroupListener |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Path
このコマンドレットによって変更される可用性グループ リスナーのパスを指定します。 このパラメーターを指定しない場合、このコマンドレットは現在の作業場所を使用します。
Type: | String |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Port
リスナーが接続をリッスンするポートを指定します。 既定のポートは TCP ポート 1433 です。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Script
このコマンドレットによって、このコマンドレットが実行するタスクを実行する Transact-SQL スクリプトが返されることを示します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
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.AvailabilityGroupListener