共用方式為


New-AzAvailabilityGroupListener

建立或更新可用性群組接聽程式。

語法

New-AzAvailabilityGroupListener
   -Name <String>
   -ResourceGroupName <String>
   -SqlVMGroupName <String>
   [-SubscriptionId <String>]
   [-AvailabilityGroupConfigurationReplica <IAgReplica[]>]
   [-AvailabilityGroupName <String>]
   [-CreateDefaultAvailabilityGroupIfNotExist]
   [-IpAddress <String>]
   [-LoadBalancerResourceId <String>]
   [-ProbePort <Int32>]
   [-PublicIpAddressResourceId <String>]
   [-SqlVirtualMachineId <String[]>]
   [-SubnetId <String>]
   [-MultiSubnetIPConfiguration <IMultiSubnetIPConfiguration[]>]
   [-Port <Int32>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

建立或更新可用性群組接聽程式。

範例

範例 1

New-AzAvailabilityGroupListener -ResourceGroupName 'ResourceGroup01' -SqlVMGroupName 'sqlvmgroup01' -Name 'AgListener01' -AvailabilityGroupName 'AG01' -IpAddress '192.168.16.7' -LoadBalancerResourceId $LoadBalancerResourceId -SubnetId $SubnetResourceId -ProbePort 9999 -SqlVirtualMachineId $sqlvmResourceId1,$sqlvmResourceId2

Name         ResourceGroupName
----         -----------------
AgListener01 ResourceGroup01

使用 SQL 虛擬機群組 「sqlvmgroup01」 中可用性群組 “AG01” 的 Load Balancer 組態,建立新的可用性群組接聽程式 “AgListener01”。

範例 2

$msconfig1 = New-AzSqlVirtualMachineMultiSubnetIPConfigurationObject -PrivateIPAddressSubnetResourceId $SubnetResourceId1 -PrivateIPAddressIpaddress '192.168.16.9' -SqlVirtualMachineInstance $sqlvmResourceId1
$msconfig2 = New-AzSqlVirtualMachineMultiSubnetIPConfigurationObject -PrivateIPAddressSubnetResourceId $SubnetResourceId2 -PrivateIPAddressIpaddress '192.168.17.9' -SqlVirtualMachineInstance $sqlvmResourceId2

New-AzAvailabilityGroupListener -Name 'AgListener02' -ResourceGroupName 'ResourceGroup01' -SqlVMGroupName 'sqlvmgroup01' -AvailabilityGroupName 'AG02' -MultiSubnetIPConfiguration $msconfig1,$msconfig2

Name         ResourceGroupName
----         -----------------
AgListener02 ResourceGroup01

使用 SQL 虛擬機群組 「sqlvmgroup01」 中可用性群組 “AG02” 的多子網組態,建立新的可用性群組接聽程式 “AgListener02”。

參數

-AsJob

以作業身分執行命令

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-AvailabilityGroupConfigurationReplica

複本組態。 若要建構,請參閱 AVAILABILITYGROUPCONFIGURATIONREPLICA 屬性的 NOTES 區段,並建立哈希表。

類型:IAgReplica[]
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-AvailabilityGroupName

可用性群組的名稱。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-CreateDefaultAvailabilityGroupIfNotExist

如果預設可用性群組不存在,請建立它。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:PSObject
別名:AzureRMContext, AzureCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-IpAddress

系結至可用性群組接聽程式的私人IP位址。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-LoadBalancerResourceId

負載平衡器的資源標識碼。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-MultiSubnetIPConfiguration

AG 接聽程式的多重子網IP組態清單。 若要建構,請參閱 MULTISUBNETIPCONFIGURATION 屬性的 NOTES 區段,並建立哈希表。

類型:IMultiSubnetIPConfiguration[]
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Name

可用性群組接聽程序的名稱。

類型:String
別名:AvailabilityGroupListenerName
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-NoWait

以異步方式執行命令

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Port

接聽程式埠。

類型:Int32
Position:Named
預設值:1433
必要:False
接受管線輸入:False
接受萬用字元:False

-ProbePort

探查埠。

類型:Int32
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-PublicIpAddressResourceId

公用IP的資源識別碼。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ResourceGroupName

包含資源的資源群組名稱。 您可以從 Azure Resource Manager API 或入口網站取得此值。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-SqlVirtualMachineId

已向可用性群組接聽程式註冊的 SQL 虛擬機實例資源標識碼清單。

類型:String[]
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-SqlVMGroupName

SQL 虛擬機群組的名稱。

類型:String
別名:GroupName
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-SubnetId

用來包含私人IP的子網。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-SubscriptionId

識別 Azure 訂用帳戶的訂用帳戶標識碼。

類型:String
Position:Named
預設值:(Get-AzContext).Subscription.Id
必要:False
接受管線輸入:False
接受萬用字元:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

類型:SwitchParameter
別名:wi
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

輸出

IAvailabilityGroupListener