Test-SqlAvailabilityGroup

  • Riferimento
Modulo:
SQLServer

Valuta l'integrità di un gruppo di disponibilità.

Sintassi

Test-SqlAvailabilityGroup
    [-ShowPolicyDetails]
    [-AllowUserPolicies]
    [-NoRefresh]
    [[-Path] <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Test-SqlAvailabilityGroup
    [-ShowPolicyDetails]
    [-AllowUserPolicies]
    [-NoRefresh]
    [-InputObject] <AvailabilityGroup[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Descrizione

Il cmdlet Test-SqlAvailabilityGroup valuta l'integrità di un gruppo di disponibilità. Questo cmdlet valuta SQL Server criteri di gestione basati su criteri. Per eseguire questo cmdlet, è necessario disporre CONNECTdei diritti utente , VIEW SERVER STATEe VIEW ANY DEFINITION .

Module requirements: version 21+ on PowerShell 5.1; version 22+ on PowerShell 7.x.

Esempio

Esempio 1: Valutare l'integrità di un gruppo di disponibilità

PS C:\> Test-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups\MainAG"

Questo comando valuta l'integrità del gruppo di disponibilità denominato MainAG. Il comando restituisce un riepilogo.

Esempio 2: Valutare l'integrità di tutti i gruppi di disponibilità

PS C:\> Get-ChildItem "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups" | Test-SqlAvailabilityGroup

Questo comando ottiene tutti i gruppi di disponibilità che dispongono di repliche di disponibilità nel percorso specificato nel provider SQLSERVER: . Il comando li passa al cmdlet corrente usando l'operatore pipeline. Questo cmdlet valuta l'integrità di ogni gruppo di disponibilità.

Esempio 3: Visualizzare i risultati per ogni criterio di un gruppo di disponibilità

PS C:\> Test-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups\MainAG" -ShowPolicyDetails

Questo comando valuta l'integrità del gruppo di disponibilità denominato MainAG. Questo comando specifica il parametro ShowPolicyDetails. Vengono pertanto visualizzati i risultati della valutazione per ogni criterio di gestione basato su criteri eseguito.

Esempio 4: Visualizzare i risultati per i criteri definiti dall'utente di un gruppo di disponibilità

PS C:\> Test-SqlAvailabilityGroup -Path "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups\MainAG" -AllowUserPolicies

Questo comando valuta l'integrità del gruppo di disponibilità denominato MainAG. Il comando include i criteri definiti dall'utente in questa valutazione.

Esempio 5: Ottenere gruppi con stato di errore

PS C:\> Get-ChildItem "SQLSERVER:\Sql\Server\InstanceName\AvailabilityGroups" | Test-SqlAvailabilityGroup | Where-Object { $_.HealthState -eq "Error" }

Questo comando ottiene tutti i gruppi di disponibilità che dispongono di repliche di disponibilità nel percorso specificato nel provider SQLSERVER: . Il comando li passa al cmdlet corrente usando l'operatore pipeline. Questo cmdlet valuta l'integrità di ogni gruppo di disponibilità. Il comando passa tali risultati al cmdlet Where-Object , che restituisce i risultati in base alla proprietà HealthState .

Parametri

-AllowUserPolicies

Indica che questo cmdlet testa i criteri utente trovati nelle categorie di criteri di Always On gruppi di disponibilità.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Specifica una matrice di gruppi di disponibilità, come oggetti AvailabilityGroup. Questo cmdlet valuta l'integrità dei gruppi di disponibilità specificati da questo parametro.

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

-NoRefresh

Indica che non aggiornerà gli oggetti specificati dal parametro Path o InputObject .

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Specifica il percorso del gruppo di disponibilità valutato da questo cmdlet. Se non si specifica questo parametro, questo cmdlet usa la posizione di lavoro corrente.

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

-ShowPolicyDetails

Indica che questo cmdlet visualizza il risultato di ogni valutazione dei criteri eseguita. Il cmdlet restituisce un oggetto per ogni valutazione dei criteri. Ogni oggetto criteri include i risultati della valutazione. Queste informazioni includono se i criteri sono stati passati o meno, il nome del criterio e la categoria di criteri.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

Microsoft.SqlServer.Management.Smo.AvailabilityGroup[]