Test-SqlAvailabilityGroup
Wertet den Status einer Verfügbarkeitsgruppe aus.
Syntax
ByPath (Standardwert)
Test-SqlAvailabilityGroup
[[-Path] <String[]>]
[-ShowPolicyDetails]
[-AllowUserPolicies]
[-NoRefresh]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Test-SqlAvailabilityGroup
[-InputObject] <AvailabilityGroup[]>
[-ShowPolicyDetails]
[-AllowUserPolicies]
[-NoRefresh]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Cmdlet Test-SqlAvailabilityGroup wertet den Status einer Verfügbarkeitsgruppe aus. Dieses Cmdlet wertet SQL Server-richtlinienbasierte Verwaltungsrichtlinien aus. Zum Ausführen dieses Cmdlets benötigen Sie CONNECT,VIEW SERVER STATE und VIEW ANY DEFINITION-Benutzerrechte.
Beispiele
Beispiel 1: Bewerten der Integrität einer Verfügbarkeitsgruppe
PS C:\> Test-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups\MainAG"
Dieser Befehl wertet den Status der Verfügbarkeitsgruppe mit dem Namen "MainAG" aus. Der Befehl gibt eine Zusammenfassung zurück.
Beispiel 2: Bewerten der Integrität aller Verfügbarkeitsgruppen
PS C:\> Get-ChildItem "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups" | Test-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 wertet die Integrität jeder Verfügbarkeitsgruppe aus.
Beispiel 3: Anzeigen von Ergebnissen für jede Richtlinie einer Verfügbarkeitsgruppe
PS C:\> Test-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups\MainAG" -ShowPolicyDetails
Dieser Befehl wertet den Status der Verfügbarkeitsgruppe mit dem Namen "MainAG" aus. Dieser Befehl gibt den Parameter ShowPolicyDetails an. Daher werden die Auswertungsergebnisse für jede richtlinienbasierte Verwaltungsrichtlinie angezeigt, die ausgeführt wurde.
Beispiel 4: Anzeigen von Ergebnissen für benutzerdefinierte Richtlinien einer Verfügbarkeitsgruppe
PS C:\> Test-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups\MainAG" -AllowUserPolicies
Dieser Befehl wertet den Status der Verfügbarkeitsgruppe mit dem Namen "MainAG" aus. Der Befehl enthält benutzerdefinierte Richtlinien in dieser Auswertung.
Beispiel 5: Abrufen von Gruppen mit einem Fehlerstatus
PS C:\> Get-ChildItem "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups" | Test-SqlAvailabilityGroup | Where-Object { $_.HealthState -eq "Error" }
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 wertet die Integrität jeder Verfügbarkeitsgruppe aus. Der Befehl übergibt diese Ergebnisse an das Cmdlet Where-Object, das Ergebnisse basierend auf der HealthState-Eigenschaft zurückgibt.
Parameter
-AllowUserPolicies
Gibt an, dass dieses Cmdlet Benutzerrichtlinien in den Richtlinienkategorien von AlwaysOn-Verfügbarkeitsgruppen testet.
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 |
-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 ein Array von Verfügbarkeitsgruppen als AvailabilityGroup-Objekte an. Dieses Cmdlet wertet den Status der Verfügbarkeitsgruppen aus, die dieser Parameter angibt.
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 |
-NoRefresh
Gibt an, dass die durch den Parameter Path oder InputObject angegebenen Objekte nicht aktualisiert werden.
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 der Verfügbarkeitsgruppe an, die dieses Cmdlet auswertet. Wenn Sie diesen Parameter nicht angeben, verwendet dieses Cmdlet den aktuellen Arbeitsort.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
ByPath
| Position: | 2 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ShowPolicyDetails
Gibt an, dass dieses Cmdlet das Ergebnis jeder von ihr ausgeführten Richtlinienauswertung anzeigt. Das Cmdlet gibt ein Objekt pro Richtlinienauswertung zurück. Jedes Richtlinienobjekt enthält die Ergebnisse der Auswertung. Diese Informationen umfassen, ob die Richtlinie übergeben wurde oder nicht, der Richtlinienname und die Richtlinienkategorie.
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.