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.

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

Type:	AvailabilityReplica[]
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 Verfügbarkeitsreplikaten an. Dieser Parameter ist optional. Wenn nicht angegeben, wird der aktuelle Arbeitsstandort verwendet.

Type:	String[]
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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