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