Test-SqlDatabaseReplicaState
Wertet die Integrität einer Verfügbarkeitsdatenbank aus.
Syntax
ByPath (Standardwert)
Test-SqlDatabaseReplicaState
[[-Path] <String[]>]
[-ShowPolicyDetails]
[-AllowUserPolicies]
[-NoRefresh]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Test-SqlDatabaseReplicaState
[-InputObject] <DatabaseReplicaState[]>
[-ShowPolicyDetails]
[-AllowUserPolicies]
[-NoRefresh]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Cmdlet Test-SqlDatabaseReplicaState bewertet den Status einer Verfügbarkeitsdatenbank für alle verknüpften Verfügbarkeitsreplikate, indem sql Server policy based management (PBM)-Richtlinien ausgewertet werden. Sie müssen über CONNECT-, VIEW SERVER STATE- und VIEW ANY DEFINITION-Berechtigungen verfügen, um dieses Cmdlet auszuführen.
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 wertet den Status der Verfügbarkeitsdatenbank mit dem Namen "MainDatabase" für das Verfügbarkeitsreplikat "MainReplica" in der Verfügbarkeitsgruppe "MainAg" aus und gibt eine kurze Zusammenfassung aus.
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 wertet den Status aller Verfügbarkeitsdatenbanken in der Verfügbarkeitsgruppe "MainAg" aus und gibt eine kurze Zusammenfassung für jede Datenbank aus.
Beispiel 3: Bewerten der Integrität aller Verfügbarkeitsdatenbanken in einer Verfügbarkeitsgruppe mit Ergebnissen der PBM-Auswertung
PS C:\> Get-ChildItem "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\DatabaseReplicaStates" | Test-SqlDatabaseReplicaState -ShowPolicyDetails
Dieser Befehl wertet den Status aller Verfügbarkeitsdatenbanken in der Verfügbarkeitsgruppe "MainAg" aus und gibt die Auswertungsergebnisse für jede ausgeführte PBM-Richtlinie aus.
Beispiel 4: Bewerten der Integrität aller Verfügbarkeitsdatenbanken in einer Verfügbarkeitsgruppe und Einschließen von benutzerdefinierten Richtlinien
PS C:\> Get-ChildItem "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\DatabaseReplicaStates" | Test-SqlDatabaseReplicaState -AllowUserPolicies
Mit diesem Befehl wird der Status aller Verfügbarkeitsdatenbanken in der Verfügbarkeitsgruppe "MainAg" ausgewertet. Benutzerdefinierte Richtlinien sind in dieser Auswertung enthalten.
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" }
Mit diesem Befehl werden alle Verfügbarkeitsdatenbanken mit dem Integritätsstatus "Fehler" in der Verfügbarkeitsgruppe "MainAg" angezeigt.
Parameter
-AllowUserPolicies
Gibt an, dass dieses Cmdlet Benutzerrichtlinien in den AlwaysOn-Richtlinienkategorien ausführt.
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ügbarkeitsdatenbankstatusobjekten an. Dieses Cmdlet berechnet den Status dieser Verfügbarkeitsdatenbanken.
Parametereigenschaften
| Typ: | DatabaseReplicaState[] |
| 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 dieses Cmdlet die durch die Parameter Path oder InputObject angegebenen Objekte nicht manuell aktualisiert.
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 zu einem oder mehreren Datenbankreplikatclusterzuständen der Verfügbarkeitsdatenbank an. Dies ist ein optionaler Parameter. Wenn nicht angegeben, wird der Wert des aktuellen Arbeitsorts verwendet.
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 ausgeführten Richtlinienauswertung anzeigt. Das Cmdlet gibt ein Objekt pro Richtlinienauswertung aus, und die Ergebnisse der Auswertung sind in den Feldern des Objekts verfügbar.
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.