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.

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

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

-NoRefresh

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

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

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 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.

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