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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:AvailabilityGroup[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NoRefresh

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

Microsoft.SqlServer.Management.Smo.AvailabilityGroup[]