Remove-SqlAvailabilityGroup
Entfernt eine Verfügbarkeitsgruppe.
Syntax
ByPath (Standardwert)
Remove-SqlAvailabilityGroup
[-Path] <String[]>
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Remove-SqlAvailabilityGroup
[-InputObject] <AvailabilityGroup[]>
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Cmdlet Remove-SqlAvailabilityGroup entfernt eine Verfügbarkeitsgruppe in AlwaysOn-Verfügbarkeitsgruppen. Sie können dieses Cmdlet für jede Instanz von SQL Server ausführen, für die AlwaysOn-Verfügbarkeitsgruppen auf einem Windows Server-Failoverclustering -Knoten (WSFC) aktiviert sind, der Sicherheitsanmeldeinformationen für die Verfügbarkeitsgruppe enthält.
Beispiele
Beispiel 1: Entfernen einer Verfügbarkeitsgruppe
PS C:\> Remove-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups\MainAG"
Mit diesem Befehl wird die Verfügbarkeitsgruppe "MainAG" entfernt. Sie können diesen Befehl auf jeder Serverinstanz ausführen, die ein Verfügbarkeitsreplikat für die Verfügbarkeitsgruppe hosten.
Beispiel 2: Entfernen aller Verfügbarkeitsgruppen
PS C:\> Get-ChildItem "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups" | Remove-SqlAvailabilityGroup
Dieser Befehl ruft alle Verfügbarkeitsgruppen ab, die Verfügbarkeitsreplikate am angegebenen Speicherort im SQLSERVER:-Anbieter aufweisen. Der Befehl übergibt sie mithilfe des Pipelineoperators an das aktuelle Cmdlet. Dieses Cmdlet löscht jede Verfügbarkeitsgruppe.
Beispiel 3: Erstellen eines Skripts zum Entfernen einer Verfügbarkeitsgruppe
PS C:\> Remove-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups\MainAG" -Script
Mit diesem Befehl wird ein Transact-SQL Skript erstellt, mit dem die Verfügbarkeitsgruppe "MainAG" entfernt wird. Der Befehl führt diese Aktion nicht aus.
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 die Verfügbarkeitsgruppe an, die dieses Cmdlet entfernt.
Parametereigenschaften
| Typ: | AvailabilityGroup[] |
| 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 der Verfügbarkeitsgruppe an, die dieses Cmdlet entfernt.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ByPath
| Position: | 2 |
| Obligatorisch.: | True |
| 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 |
-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.