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]
[-AccessToken <PSObject>]
[-TrustServerCertificate]
[-HostNameInCertificate <String>]
[-Encrypt <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-SqlAvailabilityGroupListener
[-DhcpSubnet <String>]
[-StaticIp <String[]>]
[-Port <Int32>]
[-Name] <String>
[-InputObject] <AvailabilityGroup>
[-Script]
[-AccessToken <PSObject>]
[-TrustServerCertificate]
[-HostNameInCertificate <String>]
[-Encrypt <String>]
[-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 Standardport
PS C:\> New-SqlAvailabilityGroupListener -Name "MainListener" -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAG" -Port 1434
Mit 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" -Script
Dieser Befehl erstellt ein Transact-SQL-Skript, das einen Verfügbarkeitsgruppenlistener namens "MainListener" für die Verfügbarkeitsgruppe mit dem Namen "MainAG" erstellt. Der Befehl erstellt keinen Listener.
Parameter
-AccessToken
Das Zugriffstoken, das zur Authentifizierung bei SQL Server verwendet wird, als Alternative zur Benutzer-/Kennwort- oder Windows-Authentifizierung.
Dies kann z. B. verwendet werden, um eine Verbindung mit SQL Azure DB
und SQL Azure Managed Instance
mithilfe von oder Service Principal
herzustellen Managed Identity
.
Der zu verwendende Parameter kann entweder eine Zeichenfolge sein, die das Token darstellt, oder ein PSAccessToken
Objekt, das durch Ausführen Get-AzAccessToken -ResourceUrl https://database.windows.net
von zurückgegeben wird.
Dieser Parameter ist in v22 des Moduls neu.
Type: | PSObject |
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: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DhcpSubnet
Gibt eine IPv4-Adresse und eine 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.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 |
-Encrypt
Der Verschlüsselungstyp, der beim Herstellen einer Verbindung mit SQL Server verwendet werden soll.
Dieser Wert wird der Encrypt
-Eigenschaft SqlConnectionEncryptOption
des SqlConnection-Objekts des Microsoft.Data.SqlClient-Treibers zugeordnet.
In v22 des Moduls ist Optional
der Standardwert (aus Kompatibilität mit v21). In Version 23 und höher des Moduls lautet der Standardwert "Obligatorisch", was zu einer Breaking Change für vorhandene Skripts führen kann.
Dieser Parameter ist in v22 des Moduls neu.
Type: | String |
Accepted values: | Mandatory, Optional, Strict |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HostNameInCertificate
Der Hostname, der beim Überprüfen des TLS/SSL-Zertifikats von SQL Server verwendet werden soll. Sie müssen diesen Parameter übergeben, wenn Ihr SQL Server instance für "Verschlüsselung erzwingen" aktiviert ist und Sie eine Verbindung mit einem instance mithilfe des Hostnamens/Kurznamens herstellen möchten. Wenn dieser Parameter ausgelassen wird, ist die Übergabe des vollqualifizierten Domänennamens (Fully Qualified Domain Name, FQDN) an -ServerInstance erforderlich, um eine Verbindung mit einem für die Verschlüsselung erzwingen aktivierten SQL Server instance herzustellen.
Dieser Parameter ist in v22 des Moduls neu.
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: | 2 |
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: | 1 |
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: | 2 |
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-Adress- 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 |
-TrustServerCertificate
Gibt an, ob der Kanal verschlüsselt wird, während das Durchlaufen der Zertifikatkette zum Überprüfen der Vertrauensstellung umgangen wird.
In v22 des Moduls ist $true
der Standardwert (aus Kompatibilität mit v21). In Version 23 und höher des Moduls lautet der Standardwert "$false", was zu einer Breaking Change für vorhandene Skripts führen kann.
Dieser Parameter ist in v22 des Moduls neu.
Type: | SwitchParameter |
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