Freigeben über

Test-SqlAvailabilityGroup

  • Referenz
Modul:
SQLServer

Wertet den Status einer Verfügbarkeitsgruppe aus.

Syntax

Test-SqlAvailabilityGroup
    [-ShowPolicyDetails]
    [-AllowUserPolicies]
    [-NoRefresh]
    [[-Path] <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Test-SqlAvailabilityGroup
    [-ShowPolicyDetails]
    [-AllowUserPolicies]
    [-NoRefresh]
    [-InputObject] <AvailabilityGroup[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Beschreibung

Das Cmdlet "Test-SqlAvailabilityGroup" wertet die Integrität einer Verfügbarkeitsgruppe aus. Dieses Cmdlet wertet SQL Server richtlinienbasierte Verwaltungsrichtlinien aus. Um dieses Cmdlet auszuführen, müssen Sie über CONNECTVIEW SERVER STATEBenutzerrechte verfügenVIEW ANY DEFINITION.

Module requirements: version 21+ on PowerShell 5.1; version 22+ on PowerShell 7.x.

Beispiele

Beispiel 1: Bewerten der Integrität einer Verfügbarkeitsgruppe

PS C:\> Test-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups\MainAG"

Mit diesem Befehl wird die Integrität der Verfügbarkeitsgruppe mit dem Namen ausgewertet MainAG. Der Befehl gibt eine Zusammenfassung zurück.

Beispiel 2: Bewerten der Integrität aller Verfügbarkeitsgruppe

PS C:\> Get-ChildItem "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups" | Test-SqlAvailabilityGroup

Dieser Befehl ruft alle Verfügbarkeitsgruppen ab, die Verfügbarkeitsreplikate im angegebenen Speicherort im SQLSERVER: Provider enthalten. 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

Mit diesem Befehl wird die Integrität der Verfügbarkeitsgruppe mit dem Namen ausgewertet MainAG. 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

Mit diesem Befehl wird die Integrität der Verfügbarkeitsgruppe mit dem Namen ausgewertet MainAG. 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 im angegebenen Speicherort im SQLSERVER: Provider enthalten. 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 Always On Verfügbarkeitsgruppen testet.

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

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-InputObject

Gibt ein Array der Verfügbarkeitsgruppe als AvailabilityGroup-Objekte an. Dieses Cmdlet wertet die Integrität der Verfügbarkeitsgruppen aus, die dieser Parameter angibt.

Typ:AvailabilityGroup[]
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-NoRefresh

Gibt an, dass die vom Parameter Path oder InputObject angegebenen Objekte nicht aktualisiert werden.

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

-Path

Gibt den Pfad der Verfügbarkeitsgruppe an, die dieses Cmdlet auswertet. Wenn Sie diesen Parameter nicht angeben, verwendet dieses Cmdlet den aktuellen Arbeitsspeicherort.

Typ:String[]
Position:1
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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 oder nicht, den Richtliniennamen und die Richtlinienkategorie.

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

-WhatIf

Zeigt, was geschieht, 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.AvailabilityGroup[]