Freigeben über

Test-SqlDatabaseReplicaState

  • Referenz
Modul:
SQLServer

Bewertet die Integrität einer Verfügbarkeitsdatenbank.

Syntax

Test-SqlDatabaseReplicaState
    [-ShowPolicyDetails]
    [-AllowUserPolicies]
    [-NoRefresh]
    [[-Path] <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Test-SqlDatabaseReplicaState
    [-ShowPolicyDetails]
    [-AllowUserPolicies]
    [-NoRefresh]
    [-InputObject] <DatabaseReplicaState[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Beschreibung

Das Cmdlet "Test-SqlDatabaseReplicaState" bewertet die Integrität einer Verfügbarkeitsdatenbank auf allen verknüpften Verfügbarkeitsreplikaten, indem SQL Server richtlinienbasierte Verwaltungsrichtlinien (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 einer Verfügbarkeitsdatenbank

PS C:\> $Path = "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\DatabaseReplicaStates\MainReplica.MainDatabase"
PS C:\> Test-SqlDatabaseReplicaState -Path $Path

Dieser Befehl bewertet die Integrität der Verfügbarkeitsdatenbank, die im Verfügbarkeitsreplikat MainReplica in der Verfügbarkeitsgruppe MainAg benannt MainDatabase ist und eine kurze Zusammenfassung ausgibt.

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

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

Dieser Befehl bewertet die Integrität aller Verfügbarkeitsdatenbanken in der MainAg Verfügbarkeitsgruppe und gibt eine kurze Zusammenfassung für jede Datenbank aus.

Beispiel 3: Bewerten der Integrität aller Verfügbarkeitsdatenbanken in einer Verfügbarkeitsgruppe mit PBM-Auswertungsergebnissen

PS C:\> Get-ChildItem "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\DatabaseReplicaStates" | Test-SqlDatabaseReplicaState -ShowPolicyDetails

Dieser Befehl bewertet die Integrität aller Verfügbarkeitsdatenbanken in der MainAg Verfügbarkeitsgruppe und gibt die Auswertungsergebnisse für jede PBM-Richtlinie aus, die ausgeführt wurde.

Beispiel 4: Bewerten der Integrität aller Verfügbarkeitsdatenbanken in einer Verfügbarkeitsgruppe und einschließen benutzerdefinierte Richtlinien

PS C:\> Get-ChildItem "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\DatabaseReplicaStates" | Test-SqlDatabaseReplicaState -AllowUserPolicies

Dieser Befehl bewertet die Integrität aller Verfügbarkeitsdatenbanken in der MainAg Verfügbarkeitsgruppe. Die Auswertung schließt benutzerdefinierte Richtlinien ein.

Beispiel 5: Anzeigen aller Verfügbarkeitsdatenbanken in einem Fehlerstatus

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

Dieser Befehl zeigt alle Verfügbarkeitsdatenbanken 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ügbarkeitsdatenbankstatusobjekten an. Dieses Cmdlet berechnet die Integrität dieser Verfügbarkeitsdatenbanken.

Typ:DatabaseReplicaState[]
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 Datenbankreplikatclusterzuständen der Verfügbarkeitsdatenbank an. Dies ist ein optionaler Parameter. Wenn nicht angegeben, wird der Wert des aktuellen Arbeitsstandorts verwendet.

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

-ShowPolicyDetails

Gibt an, dass dieses Cmdlet das Ergebnis jeder ausgeführten Richtlinienbewertung anzeigt. Das Cmdlet gibt ein Objekt pro Richtlinienbewertung aus, und die Ergebnisse der Auswertung sind in den Feldern des Objekts verfügbar.

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