Freigeben über


Disable-SqlAlwaysOn

Deaktiviert das Feature "AlwaysOn-Verfügbarkeitsgruppen" für einen Server.

Syntax

Disable-SqlAlwaysOn
       [[-Path] <String>]
       [-NoServiceRestart]
       [-Force]
       [-Credential <PSCredential>]
       [-ProgressAction <ActionPreference>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Disable-SqlAlwaysOn
       [-InputObject] <Server>
       [-NoServiceRestart]
       [-Force]
       [-Credential <PSCredential>]
       [-ProgressAction <ActionPreference>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Disable-SqlAlwaysOn
       -ServerInstance <String>
       [-NoServiceRestart]
       [-Force]
       [-Credential <PSCredential>]
       [-ProgressAction <ActionPreference>]
       [-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.

Sie müssen über Administratorberechtigungen zum Ausführen dieses Cmdlets verfügen.

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 vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Credential

Gibt eine Windows-Anmeldeinformation an, die über die Berechtigung zum Ändern der AlwaysOn-Einstellung in der SQL Server-Instanz verfügt.

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Gibt das Serverobjekt der Instanz von SQL Server an, in der die Einstellung "Always On Availability Groups" deaktiviert ist.

Typ:Server
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren: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.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:String
Position:1
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ProgressAction

Bestimmt, wie PowerShell auf Statusaktualisierungen reagiert, die von einem Skript, Cmdlet oder Anbieter generiert werden, z. B. auf die Statusanzeigen, die vom Cmdlet Write-Progress generiert werden. Das Cmdlet Write-Progress erstellt Statusanzeigen, die den Status eines Befehls anzeigen.

Typ:ActionPreference
Aliase:proga
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.SqlServer.Management.Smo.Server

System.String

Ausgaben

System.Object