Test-SqlAvailabilityReplica
Wertet die Integrität von Verfügbarkeitsreplikaten aus.
Syntax
ByPath (Standardwert)
Test-SqlAvailabilityReplica
[[-Path] <String[]>]
[-ShowPolicyDetails]
[-AllowUserPolicies]
[-NoRefresh]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Test-SqlAvailabilityReplica
[-InputObject] <AvailabilityReplica[]>
[-ShowPolicyDetails]
[-AllowUserPolicies]
[-NoRefresh]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Cmdlet Test-SqlAvailabilityReplica bewertet den Status von Verfügbarkeitsreplikaten, 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 eines Verfügbarkeitsreplikats
PS C:\> Test-SqlAvailabilityReplica -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas\MainReplica"
Dieser Befehl wertet den Status des Verfügbarkeitsreplikats mit dem Namen "MainReplica" in der Verfügbarkeitsgruppe "MainAg" aus 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 wertet den Status aller Verfügbarkeitsreplikate in der Verfügbarkeitsgruppe mit dem Namen "MainAg" aus 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 wertet den Status des Verfügbarkeitsreplikats mit dem Namen "MainReplica" in der Verfügbarkeitsgruppe "MainAg" aus und gibt die Auswertungsergebnisse für jede ausgeführte PBM-Richtlinie aus.
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 wertet den Status des Verfügbarkeitsreplikats mit dem Namen "MainReplica" in der Verfügbarkeitsgruppe "MainAg" aus. Benutzerdefinierte Richtlinien sind in dieser Auswertung enthalten.
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" }
Mit diesem Befehl werden alle Verfügbarkeitsreplikate 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ügbarkeitsreplikaten an, die ausgewertet werden sollen.
Parametereigenschaften
| Typ: | AvailabilityReplica[] |
| 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 Verfügbarkeitsreplikaten an. Dieser Parameter ist optional. Wenn nicht angegeben, wird der aktuelle Arbeitsort 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 das Ergebnis jeder von diesem Cmdlet ausgeführten Richtlinienauswertung angezeigt wird. Das Cmdlet gibt ein Objekt pro Richtlinienauswertung aus. Dieses Objekt enthält Felder, die die Ergebnisse der Auswertung beschreiben.
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.