Freigeben über

Test-SqlAvailabilityReplica

  • Referenz
Modul:
SQLServer

Bewertet die Integrität der Verfügbarkeitsreplikate.

Syntax

Test-SqlAvailabilityReplica
    [-ShowPolicyDetails]
    [-AllowUserPolicies]
    [-NoRefresh]
    [[-Path] <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Test-SqlAvailabilityReplica
    [-ShowPolicyDetails]
    [-AllowUserPolicies]
    [-NoRefresh]
    [-InputObject] <AvailabilityReplica[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Beschreibung

Das Cmdlet Test-SqlAvailabilityReplica bewertet die Integrität der Verfügbarkeitsreplikate, indem SQL Server Richtlinienbasierte Verwaltung (PBM) ausgewertet werden. Sie müssen über , VIEW SERVER STATEund VIEW ANY DEFINITION Berechtigungen zum Ausführen dieses Cmdlets verfügenCONNECT.

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

Beispiele

Beispiel 1: Bewerten der Integrität eines Verfügbarkeitsreplikats

PS C:\> Test-SqlAvailabilityReplica -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas\MainReplica"

Dieser Befehl bewertet die Integrität des Verfügbarkeitsreplikats, das in der MainAg Verfügbarkeitsgruppe benannt MainReplica ist, und gibt eine kurze Zusammenfassung aus.

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

PS C:\> Get-ChildItem "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas" | Test-SqlAvailabilityReplica

Dieser Befehl bewertet die Integrität aller Verfügbarkeitsreplikate in der Verfügbarkeitsgruppe namens MainAg und gibt eine kurze Zusammenfassung für jedes Replikat aus.

Beispiel 3: Bewerten der Integrität eines Verfügbarkeitsreplikats für jede PBM-Richtlinie

PS C:\> Test-SqlAvailabilityReplica -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas\MainReplica" -ShowPolicyDetails

Dieser Befehl bewertet die Integrität des Verfügbarkeitsreplikats, das in der MainAg Verfügbarkeitsgruppe benannt MainReplica ist, und gibt die Auswertungsergebnisse für jede PBM-Richtlinie aus, die ausgeführt wurde.

Beispiel 4: Bewerten der Integrität eines Verfügbarkeitsreplikats und einschließen von benutzerdefinierten Richtlinien

PS C:\> Test-SqlAvailabilityReplica -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas\MainReplica" -AllowUserPolicies

Dieser Befehl bewertet die Integrität des Verfügbarkeitsreplikats, das in der MainAg Verfügbarkeitsgruppe benannt MainReplica ist. Die Auswertung schließt benutzerdefinierte Richtlinien ein.

Beispiel 5: Anzeigen aller Verfügbarkeitsreplikate, die sich in einem Fehlerzustand befinden

PS C:\> Get-ChildItem "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas" | Test-SqlAvailabilityReplica | Where-Object { $_.HealthState -eq "Error" }

Dieser Befehl zeigt alle Verfügbarkeitsreplikate mit einem Integritätsstatus Error in der MainAg Verfügbarkeitsgruppe an.

Parameter

-AllowUserPolicies

Gibt an, dass dieses Cmdlet Benutzerrichtlinien in den Always On Richtlinienkategorien ausführt.

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 von Verfügbarkeitsreplikaten an, die ausgewertet werden sollen.

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

-NoRefresh

Gibt an, dass dieses Cmdlet die von den Parametern Path oder InputObject angegebenen Objekte nicht manuell aktualisiert.

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

-Path

Gibt den Pfad zu einem oder mehreren Verfügbarkeitsreplikaten an. Dieser Parameter ist optional. Wenn nicht angegeben, wird der aktuelle Arbeitsstandort verwendet.

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

-ShowPolicyDetails

Gibt an, dass das Ergebnis jeder von diesem Cmdlet ausgeführten Richtlinienbewertung angezeigt wird. Das Cmdlet gibt ein Objekt pro Richtlinienbewertung aus. Dieses Objekt enthält Felder, die die Ergebnisse der Auswertung beschreiben.

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.AvailabilityReplica[]