New-SqlAvailabilityGroupListener
Erstellt einen Verfügbarkeitsgruppenlistener und fügt ihn an eine Verfügbarkeitsgruppe an.
Syntax
New-SqlAvailabilityGroupListener
[-DhcpSubnet <String>]
[-StaticIp <String[]>]
[-Port <Int32>]
[-Name] <String>
[[-Path] <String>]
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-SqlAvailabilityGroupListener
[-DhcpSubnet <String>]
[-StaticIp <String[]>]
[-Port <Int32>]
[-Name] <String>
[-InputObject] <AvailabilityGroup>
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Beschreibung
Das Cmdlet New-SqlAvailabilityGroupListener erstellt einen Verfügbarkeitsgruppenlistener und fügt ihn an eine Verfügbarkeitsgruppe an. Führen Sie dieses Cmdlet auf dem Server instance aus, der das primäre Replikat hostet.
Beispiele
Beispiel 1: Erstellen eines Listeners für eine Verfügbarkeitsgruppe
PS C:\> New-SqlAvailabilityGroupListener -Name "MainListener" -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAG"Mit diesem Befehl wird ein Verfügbarkeitsgruppenlistener namens MainListener für die Verfügbarkeitsgruppe MainAG erstellt. Dieser Listener ruft mithilfe von DHCP eine virtuelle IP-Adresse ab. Führen Sie diesen Befehl auf dem Server instance aus, der das primäre Replikat hostet.
Beispiel 2: Erstellen eines Listeners für eine Verfügbarkeitsgruppe mit einem nicht standardmäßigen Port
PS C:\> New-SqlAvailabilityGroupListener -Name "MainListener" -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAG" -Port 1434Mit diesem Befehl wird ein Verfügbarkeitsgruppenlistener namens MainListener für die Verfügbarkeitsgruppe MainAG erstellt. Wie im vorherigen Beispiel ruft dieser Listener mithilfe von DHCP eine virtuelle IP-Adresse ab. In diesem Beispiel wird der Port 1434 zugewiesen, an dem er lauscht.
Beispiel 3: Erstellen eines Listeners für eine Verfügbarkeitsgruppe, die DHCP verwendet
PS C:\> New-SqlAvailabilityGroupListener -Name "MainListener" -DhcpSubnet "192.169.0.1/255.255.252.0" -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAG"Mit diesem Befehl wird ein Verfügbarkeitsgruppenlistener namens MainListener für die Verfügbarkeitsgruppe MainAG erstellt. Dieser Listener ruft mithilfe von DHCP eine virtuelle IP-Adresse im angegebenen Subnetz ab.
Beispiel 4: Erstellen eines Listeners für eine Verfügbarkeitsgruppe, die eine statische Adresse verwendet
PS C:\> New-SqlAvailabilityGroupListener -Name "MainListener" -StaticIp "192.168.3.1/255.255.252.0" -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAG"Mit diesem Befehl wird ein Verfügbarkeitsgruppenlistener namens MainListener für die Verfügbarkeitsgruppe MainAG erstellt. Dieser Listener verwendet die vom StaticIp-Parameter angegebene IPv4-Adresse als virtuelle IP-Adresse.
Beispiel 5: Erstellen eines Skripts, das einen Listener erstellt
PS C:\> New-SqlAvailabilityGroupListener -Name "MainListener" -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAG" -ScriptMit diesem Befehl wird ein Transact-SQL-Skript erstellt, das einen Verfügbarkeitsgruppenlistener mit dem Namen MainListener für die Verfügbarkeitsgruppe MainAG erstellt. Der Befehl erstellt keinen Listener.
Parameter
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DhcpSubnet
Gibt eine IPv4-Adresse und Subnetzmaske eines Netzwerks an. Der Listener bestimmt die Adresse in diesem Netzwerk mithilfe von DHCP. Geben Sie die Adresse in für das folgende Format an: 192.168.0.1\255.255.255.0.
Wenn Sie diesen Parameter angeben, geben Sie nicht den StaticIp-Parameter an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Gibt die Verfügbarkeitsgruppe als AvailabilityGroup-Objekt an, an das dieses Cmdlet den Listener anfügt.
| Type: | AvailabilityGroup |
| Position: | 3 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Gibt einen Namen für den Listener an.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
Gibt den Pfad der Verfügbarkeitsgruppe an, an die dieses Cmdlet einen Listener anfügt. Wenn Sie diesen Parameter nicht angeben, verwendet dieses Cmdlet den aktuellen Arbeitsstandort.
| Type: | String |
| Position: | 3 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Port
Gibt den Port an, an dem der Listener auf Verbindungen lauscht. Der Standardport ist TCP-Port 1433.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Script
Gibt an, dass dieses Cmdlet ein Transact-SQL-Skript zurückgibt, das die Aufgabe ausführt, die dieses Cmdlet ausführt.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StaticIp
Gibt ein Array von Adressen an. Jeder Adresseintrag ist entweder eine IPv4-Adresse und Subnetzmaske oder eine IPv6-Adresse. Der Listener lauscht auf die Adressen, die dieser Parameter angibt.
Wenn Sie diesen Parameter angeben, geben Sie nicht den DhcpSubnet-Parameter an.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| 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: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Eingaben
Microsoft.SqlServer.Management.Smo.AvailabilityGroup