Add-SqlAvailabilityGroupListenerStaticIp
Fügt einem Verfügbarkeitsgruppenlistener eine statische IP-Adresse hinzu.
Syntax
ByPath (Standardwert)
Add-SqlAvailabilityGroupListenerStaticIp
[[-Path] <String[]>]
-StaticIp <String[]>
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Add-SqlAvailabilityGroupListenerStaticIp
[-InputObject] <AvailabilityGroupListener[]>
-StaticIp <String[]>
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Cmdlet Add-SqlAvailabilityGroupListenerStaticIp fügt einer vorhandenen Listenerkonfiguration für Verfügbarkeitsgruppen eine statische IP-Adresse hinzu. Sie können entweder eine IPv4-Adresse und ein Subnetzformat oder eine IPv6-Adresse angeben, mit der dieses Cmdlet auf der Serverinstanz ausgeführt wird, die das primäre Replikat hostt.
Beispiele
Beispiel 1: Hinzufügen einer IPv4-Adresse
PS C:\> Add-SqlAvailabilityGroupListenerStaticIp -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityGroupListeners\MainListener" -StaticIp "192.169.0.1/255.255.252.0"
Mit diesem Befehl wird dem Verfügbarkeitsgruppenlistener MainListener in der Verfügbarkeitsgruppe "MainAG" eine statische IPv4-Adresse hinzugefügt. Diese IPv4-Adresse dient als virtuelle IP-Adresse des Listeners im Subnetz 255.255.252.0. Wenn die Verfügbarkeitsgruppe mehrere Subnetze umfasst, fügen Sie dem Listener eine statische IP-Adresse für jedes Subnetz hinzu. Führen Sie dieses Cmdlet auf der Serverinstanz aus, die das primäre Replikat hosten soll.
Beispiel 2: Hinzufügen einer IPv6-Adresse
PS C:\> Add-SqlAvailabilityGroupListenerStaticIp -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityGroupListeners\MainListener" -StaticIp "2001:0db8:85a3:0000:0000:8a2e:0370:7334"
Mit diesem Befehl wird dem Listener MainListener eine statische IPv6-Adresse für die Verfügbarkeitsgruppe MainAG hinzugefügt.
Beispiel 3: Erstellen eines Skripts, das eine IPv4-Adresse hinzufügt
PS C:\> Add-SqlAvailabilityGroupListenerStaticIp -Path "SQLSERVER:\SQL\PrimaryServer\InstanceName\AvailabilityGroups\MainAg\AvailabilityGroupListeners\MainListener" -StaticIp "192.168.0.1/255.255.255.0" -Script
Dadurch wird ein Transact-SQL Skript erstellt, das dem Verfügbarkeitsgruppenlistener MainListener in der Verfügbarkeitsgruppe "MainAG" eine statische IPv4-Adresse hinzufügt.
Parameter
-Confirm
Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-InputObject
Gibt den Listener als AvailabilityGroupListener -Objekt an, das dieses Cmdlet ändert.
Parametereigenschaften
| Typ: | AvailabilityGroupListener[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ByObject
| Position: | 2 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Path
Gibt den Pfad des Verfügbarkeitsgruppenlisteners an, den dieses Cmdlet ändert. Wenn Sie diesen Parameter nicht angeben, verwendet dieses Cmdlet den aktuellen Arbeitsort.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ByPath
| Position: | 2 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Script
Gibt an, dass dieses Cmdlet ein Transact-SQL Skript zurückgibt, das die aufgabe ausführt, die dieses Cmdlet ausführt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-StaticIp
Gibt ein Array von Adressen an. Jeder Adresseintrag ist entweder eine IPv4-Adresse und ein Subnetzformat oder eine IPv6-Adresse. Der Listener lauscht auf die Adressen, die dieser Parameter angibt.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | False |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.