New-AzAvailabilityGroupListener

  • リファレンス
モジュール:
Az.SqlVirtualMachine

可用性グループ リスナーを作成または更新します。

構文

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>]

説明

可用性グループ リスナーを作成または更新します。

例

例 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" のロード バランサー構成を使用して、新しい可用性グループ リスナー "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

コマンドをジョブとして実行する

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AvailabilityGroupConfigurationReplica

レプリカ構成。 構築するには、AVAILABILITYGROUPCONFIGURATIONREPLICA プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。

Type:IAgReplica[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AvailabilityGroupName

可用性グループの名前。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CreateDefaultAvailabilityGroupIfNotExist

既定の可用性グループが存在しない場合は作成します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。

Type:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IpAddress

可用性グループ リスナーにバインドされたプライベート IP アドレス。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LoadBalancerResourceId

ロード バランサーのリソース ID。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MultiSubnetIPConfiguration

AG リスナーのマルチ サブネット IP 構成の一覧。 構築するには、MULTISUBNETIPCONFIGURATION プロパティの NOTES セクションを参照し、ハッシュ テーブルを作成します。

Type:IMultiSubnetIPConfiguration[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

可用性グループ リスナーの名前。

Type:String
Aliases:AvailabilityGroupListenerName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NoWait

コマンドを非同期的に実行する

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Port

リスナー ポート。

Type:Int32
Position:Named
Default value:1433
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProbePort

プローブ ポート。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublicIpAddressResourceId

パブリック IP のリソース ID。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

リソースが含まれているリソース グループの名前。 この値は、Azure リソース マネージャー API またはポータルから取得できます。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SqlVirtualMachineId

可用性グループ リスナーに登録されている SQL 仮想マシン インスタンスリソース ID の一覧。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SqlVMGroupName

SQL 仮想マシン グループの名前。

Type:String
Aliases:GroupName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SubnetId

プライベート IP を含めるために使用されるサブネット。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

Azure サブスクリプションを識別するサブスクリプション ID。

Type:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

出力

IAvailabilityGroupListener

メモ

別名

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

以下で説明するパラメーターを作成するには、適切なプロパティを含むハッシュ テーブルを作成します。 ハッシュ テーブルの詳細については、Get-Help about_Hash_Tablesを実行します。

AVAILABILITYGROUPCONFIGURATIONREPLICA <IAgReplica[]>: レプリカ構成。

  • [Commit <Commit?>]: 可用性グループのレプリカ コミット モード。
  • [Failover <Failover?>]: 可用性グループのレプリカ フェールオーバー モード。
  • [ReadableSecondary <ReadableSecondary?>]: 可用性グループ内の読み取り可能なセカンダリ モードのレプリカ。
  • [Role <Role?>]: 可用性グループのレプリカ ロール。
  • [SqlVirtualMachineInstanceId <String>]: Sql VirtualMachine インスタンス ID。

MULTISUBNETIPCONFIGURATION <IMultiSubnetIPConfiguration[]>: AG リスナーのマルチ サブネット IP 構成の一覧。

  • SqlVirtualMachineInstance <String>: 可用性グループ リスナーに登録されている SQL 仮想マシン インスタンスのリソース ID。
  • [PrivateIPAddressIpaddress <String>]: 可用性グループ リスナーにバインドされたプライベート IP アドレス。
  • [PrivateIPAddressSubnetResourceId <String>]: プライベート IP を含めるために使用されるサブネット。