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 |