Remove-SqlAvailabilityDatabase
Entfernt eine Verfügbarkeitsdatenbank aus der Verfügbarkeitsgruppe.
Syntax
ByPath (Standardwert)
Remove-SqlAvailabilityDatabase
[-Path] <String[]>
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Remove-SqlAvailabilityDatabase
[-InputObject] <AvailabilityDatabase[]>
[-Script]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Cmdlet Remove-SqlAvailabilityDatabase entfernt die Verfügbarkeitsdatenbank aus der Verfügbarkeitsgruppe. Der Parameter InputObject oder Path gibt die Verfügbarkeitsdatenbank an.
Wenn Sie dieses Cmdlet auf der Serverinstanz ausführen, die das primäre Replikat hostet, entfernt das Cmdlet die primäre Datenbank und alle entsprechenden sekundären Datenbanken aus der Verfügbarkeitsgruppe.
Wenn Sie dieses Cmdlet auf einer Serverinstanz ausführen, die ein sekundäres Replikat hostet, entfernt das Cmdlet nur die lokale sekundäre Datenbank aus der Verfügbarkeitsgruppe. Die sekundäre Datenbank ist nicht mehr mit der Verfügbarkeitsgruppe verknüpft, aber andere Kopien der Datenbank werden weiterhin verknüpft.
Beispiele
Beispiel 1: Entfernen einer Datenbank aus einer Verfügbarkeitsgruppe
PS C:\> Remove-SqlAvailabilityDatabase -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityDatabases\Database16"
Mit diesem Befehl wird die Verfügbarkeitsdatenbank "Database16" aus der Verfügbarkeitsgruppe "MainAG" entfernt. Dieser Befehl wird auf der Serverinstanz ausgeführt, die das primäre Replikat hosten soll. Daher werden die primäre Datenbank und alle entsprechenden sekundären Datenbanken aus der Verfügbarkeitsgruppe entfernt. Die Datensynchronisierung findet für diese Datenbank für jedes sekundäre Replikat nicht mehr statt.
Beispiel 2: Entfernen aller Datenbanken aus einer Verfügbarkeitsgruppe
PS C:\> Get-ChildItem "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityDatabases" | Remove-SqlAvailabilityDatabase
Dieser Befehl ruft alle Verfügbarkeitsdatenbanken ab, die zu MainAG gehören, und übergibt sie dann mithilfe des Pipelineoperators an das aktuelle Cmdlet. Das aktuelle Cmdlet entfernt jede Verfügbarkeitsdatenbank.
Beispiel 3: Entfernen einer sekundären Datenbank aus einer Verfügbarkeitsgruppe
PS C:\> Remove-SqlAvailabilityDatabase -Path "SQLSERVER:\Sql\SecondaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityDatabases\Database16"
Mit diesem Befehl wird die sekundäre Datenbank "Database16" aus dem sekundären Replikat entfernt, das von der Serverinstanz mit dem Namen SecondaryServer\Instance gehostet wird. Die Datensynchronisierung mit den entfernten sekundären Datenbanken wird beendet. Dieser Befehl wirkt sich nicht auf die primäre Datenbank oder andere sekundäre Datenbanken aus.
Um die Datensynchronisierung für diese sekundäre Datenbank neu zu starten, verknüpfen Sie sie erneut mit der Verfügbarkeitsgruppe, indem Sie das Cmdlet "Add-SqlAvailabilityDatabase" auf derselben Serverinstanz ausführen.
Beispiel 4: Erstellen eines Skripts zum Entfernen einer Datenbank aus einer Verfügbarkeitsgruppe
PS C:\> Remove-SqlAvailabilityDatabase -Path "SQLSERVER:\Sql\PrimaryServer\InstanceName\AvailabilityGroups\MainAG\AvailabilityDatabases\Database16" -Script
Mit diesem Befehl wird ein Transact-SQL Skript erstellt, mit dem die Verfügbarkeitsdatenbank "Database16" aus der 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ügbarkeitsdatenbank als AvailabilityDatabase-Objekt an, die dieses Cmdlet entfernt.
Parametereigenschaften
| Typ: | AvailabilityDatabase[] |
| 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 einer Verfügbarkeitsdatenbank an, die vom Cmdlet entfernt wird.
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.
Eingaben
Microsoft.SqlServer.Management.Smo.AvailabilityDatabase
Sie können eine Verfügbarkeitsdatenbank an dieses Cmdlet übergeben.