New-AzAvailabilityGroupListener

Erstellt oder aktualisiert einen Verfügbarkeitsgruppenlistener.

Syntax

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

Beschreibung

Erstellt oder aktualisiert einen Verfügbarkeitsgruppenlistener.

Beispiele

Beispiel 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

Erstellen Sie einen neuen Verfügbarkeitsgruppenlistener "AgListener01" mit Lastenausgleichskonfiguration für die Verfügbarkeitsgruppe "AG01" in der SQL Virtual Machine Group "sqlvmgroup01".

Beispiel 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

Erstellen Sie einen neuen Verfügbarkeitsgruppenlistener "AgListener02" mit Multi-Subnets-Konfiguration für die Verfügbarkeitsgruppe "AG02" in der SQL Virtual Machine Group "sqlvmgroup01".

Parameter

-AsJob

Ausführen des Befehls als Auftrag

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

-AvailabilityGroupConfigurationReplica

Replikatkonfigurationen. Informationen zum Erstellen finden Sie im ABSCHNITT "NOTES" für AVAILABILITYGROUPCONFIGURATIONREPLICA-Eigenschaften und erstellen eine Hashtabelle.

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

-AvailabilityGroupName

Der Name der Verfügbarkeitsgruppe.

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

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-CreateDefaultAvailabilityGroupIfNotExist

Erstellen Sie eine Standardverfügbarkeitsgruppe, falls sie nicht vorhanden ist.

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

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

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

-IpAddress

Private IP-Adresse, die an den Verfügbarkeitsgruppenlistener gebunden ist.

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

-LoadBalancerResourceId

Ressourcen-ID des Lastenausgleichs.

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

-MultiSubnetIPConfiguration

Liste der Konfigurationen für mehrere Subnetz-IP-Adressen für einen AG-Listener. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für MULTISUBNETIPCONFIGURATION-Eigenschaften und erstellen eine Hashtabelle.

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

-Name

Name des Verfügbarkeitsgruppenlisteners.

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

-NoWait

Asynchrones Ausführen des Befehls

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

-Port

Listenerport.

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

-ProbePort

Probeanschluss.

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

-PublicIpAddressResourceId

Ressourcen-ID der öffentlichen IP.

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

-ResourceGroupName

Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.

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

-SqlVirtualMachineId

Liste der RESSOURCEN-IDs der SQL-Vm-Instanz, die für den Verfügbarkeitsgruppenlistener registriert sind.

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

-SqlVMGroupName

Name der SQL-Gruppe virtueller Computer.

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

-SubnetId

Subnetz, das verwendet wird, um private IP einzuschließen.

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

-SubscriptionId

Abonnement-ID, die ein Azure-Abonnement identifiziert.

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Ausgaben

IAvailabilityGroupListener

Hinweise

ALIASE

KOMPLEXE PARAMETEREIGENSCHAFTEN

Um die unten beschriebenen Parameter zu erstellen, erstellen Sie eine Hashtabelle mit den entsprechenden Eigenschaften. Informationen zu Hashtabellen finden Sie unter "Get-Help about_Hash_Tables".

AVAILABILITYGROUPCONFIGURATIONREPLICA <IAgReplica[]>: Replikatkonfigurationen.

  • [Commit <Commit?>]: Replikat-Commitmodus in der Verfügbarkeitsgruppe.
  • [Failover <Failover?>]: Replikatfailovermodus in der Verfügbarkeitsgruppe.
  • [ReadableSecondary <ReadableSecondary?>]: Replikat lesbarer sekundärer Modus in der Verfügbarkeitsgruppe.
  • [Role <Role?>]: Replikatrolle in der Verfügbarkeitsgruppe.
  • [SqlVirtualMachineInstanceId <String>]: SQL VirtualMachine-Instanz-ID.

MULTISUBNETIPCONFIGURATION <IMultiSubnetIPConfiguration[]>: Liste der Konfigurationen für mehrere Subnetze für einen AG-Listener.

  • SqlVirtualMachineInstance <String>: Ressourcen-ID der SQL-Instanz des virtuellen Computers, die für den Verfügbarkeitsgruppenlistener registriert sind.
  • [PrivateIPAddressIpaddress <String>]: Private IP-Adresse, die an den Verfügbarkeitsgruppenlistener gebunden ist.
  • [PrivateIPAddressSubnetResourceId <String>]: Subnetz, das verwendet wird, um private IP einzuschließen.