Disable-SqlAlwaysOn
Deaktiviert das Feature "AlwaysOn-Verfügbarkeitsgruppen" für einen Server.
Syntax
ByPath (Standardwert)
Disable-SqlAlwaysOn
[[-Path] <String>]
[-NoServiceRestart]
[-Force]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Disable-SqlAlwaysOn
[-InputObject] <Server>
[-NoServiceRestart]
[-Force]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByName
Disable-SqlAlwaysOn
-ServerInstance <String>
[-NoServiceRestart]
[-Force]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das cmdlet Disable-SqlAlwaysOn deaktiviert das Feature "Always On vailability groups" in einer SQL Server-Instanz.
Wenn das Feature "Always On Availability Groups" deaktiviert ist, während der SQL Server-Dienst ausgeführt wird, muss der Datenbankmoduldienst neu gestartet werden, damit die Änderungen abgeschlossen werden.
Sofern Sie den Parameter Force nicht angeben, werden Sie vom Cmdlet aufgefordert, den Dienst neu zu starten.
Wenn das Feature "AlwaysOn-Verfügbarkeitsgruppen" bereits deaktiviert ist, nimmt dieses Cmdlet keine Änderungen vor.
Dieses Cmdlet kann für einen Remotedienst ausgeführt werden.
Zum Ausführen dieses Cmdlets benötigen Sie Administratorberechtigungen.
Module requirements: version 21+ on PowerShell 5.1; version 22+ on PowerShell 7.x.
Beispiele
Beispiel 1: Deaktivieren von Always On-Verfügbarkeitsgruppen am angegebenen Pfad
PS C:\> Disable-SqlAlwaysOn -Path "SQLSERVER:\Sql\Computer\Instance"
Mit diesem Befehl werden AlwaysOn-Verfügbarkeitsgruppen für die Instanz von SQL Server deaktiviert, die sich im angegebenen Pfad befindet. Dieser Befehl erfordert einen Neustart der Serverinstanz, und Sie werden aufgefordert, diesen Neustart zu bestätigen.
Beispiel 2: Deaktivieren von AlwaysOn-Verfügbarkeitsgruppen im angegebenen Pfad und Neustarten des Servers ohne Bestätigung
PS C:\> Disable-SqlAlwaysOn -Path "SQLSERVER:\Sql\Computer\Instance" -Force
Mit diesem Befehl werden AlwaysOn-Verfügbarkeitsgruppen für die Instanz von SQL Server deaktiviert, die sich im angegebenen Pfad befindet. Die Option "Erzwingen" bewirkt, dass die Serverinstanz neu gestartet wird, ohne Dass Sie zur Bestätigung aufgefordert werden.
Beispiel 3: Deaktivieren von AlwaysOn-Verfügbarkeitsgruppen für die angegebene Serverinstanz
PS C:\> Disable-SqlAlwaysOn -ServerInstance "Computer\Instance"
Mit diesem Befehl werden AlwaysOn-Verfügbarkeitsgruppen für die Instanz von SQL Server mit dem Namen 'Computer\Instance' deaktiviert. Dieser Befehl erfordert einen Neustart der Instanz, und Sie werden aufgefordert, diesen Neustart zu bestätigen.
Beispiel 4: Deaktivieren von AlwaysOn-Verfügbarkeitsgruppen für die angegebene Serverinstanz mithilfe der Windows-Authentifizierung
PS C:\> Disable-SqlAlwaysOn -ServerInstance "Computer\Instance" -Credential (Get-Credential "DOMAIN\Username")
Mit diesem Befehl werden AlwaysOn-Verfügbarkeitsgruppen für die Instanz von SQL Server mit dem Namen "Computer\Instance" mithilfe der Windows-Authentifizierung deaktiviert. Sie werden aufgefordert, das Kennwort für das angegebene Konto "DOMÄNE\Benutzername" einzugeben. Diese Änderung erfordert einen Neustart der Instanz, und Sie werden ebenfalls aufgefordert, diesen Neustart zu bestätigen.
Beispiel 5: Deaktivieren von AlwaysOn-Verfügbarkeitsgruppen im angegebenen Pfad, ohne den Server neu zu starten
PS C:\> Disable-SqlAlwaysOn -Path "SQLSERVER:\Sql\Computer\Instance" -NoServiceRestart
Mit diesem Befehl werden AlwaysOn-Verfügbarkeitsgruppen für die Instanz von SQL Server deaktiviert, die sich im angegebenen Pfad befindet, der Befehl startet die Instanz jedoch nicht neu. Die Änderung wird erst wirksam, wenn Sie diese Serverinstanz manuell neu starten.
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 |
-Credential
Gibt eine Windows-Anmeldeinformation an, die über die Berechtigung zum Ändern der AlwaysOn-Einstellung in der SQL Server-Instanz verfügt.
Parametereigenschaften
| Typ: | PSCredential |
| 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 |
-Force
Erzwingt die Ausführung des Befehls, ohne eine Benutzerbestätigung zu verlangen. Dieser Parameter wird bereitgestellt, um die Erstellung von Skripts zu ermöglichen.
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 |
-InputObject
Gibt das Serverobjekt der Instanz von SQL Server an, in der die Einstellung "Always On Availability Groups" deaktiviert ist.
Parametereigenschaften
| Typ: | Server |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ByObject
| Position: | 1 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-NoServiceRestart
Gibt an, dass der Benutzer nicht aufgefordert wird, den SQL Server-Dienst neu zu starten. Sie müssen den SQL Server-Dienst manuell neu starten, damit Änderungen wirksam werden. Wenn dieser Parameter festgelegt ist, wird Force ignoriert.
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 |
-Path
Gibt den Pfad zur Instanz des SQL Server an. Dies ist ein optionaler Parameter. Wenn nicht angegeben, wird der Wert des aktuellen Arbeitsorts verwendet.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ByPath
| Position: | 1 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ServerInstance
Gibt den Namen der Instanz von SQL Server an, auf der Always On deaktiviert ist. Das Format sollte MACHINENAME\INSTANCE sein. Verwenden Sie den Parameter "Credential", um die Einstellung "AlwaysOn" auf einem Remoteserver zu ändern.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ByName
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| 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.