Condividi tramite

Test-SqlAvailabilityReplica

  • Riferimento
Modulo:
SQLServer

Valuta l'integrità delle repliche di disponibilità.

Sintassi

Test-SqlAvailabilityReplica
    [-ShowPolicyDetails]
    [-AllowUserPolicies]
    [-NoRefresh]
    [[-Path] <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Test-SqlAvailabilityReplica
    [-ShowPolicyDetails]
    [-AllowUserPolicies]
    [-NoRefresh]
    [-InputObject] <AvailabilityReplica[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Descrizione

Il cmdlet Test-SqlAvailabilityReplica valuta l'integrità delle repliche di disponibilità SQL Server valutando i criteri di gestione basata su criteri (PBM). È necessario disporre CONNECTdi autorizzazioni , VIEW SERVER STATEe VIEW ANY DEFINITION per eseguire questo cmdlet.

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

Esempio

Esempio 1: Valutare l'integrità di una replica di disponibilità

PS C:\> Test-SqlAvailabilityReplica -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas\MainReplica"

Questo comando valuta l'integrità della replica di disponibilità denominata MainReplica nel MainAg gruppo di disponibilità e restituisce un breve riepilogo.

Esempio 2: Valutare l'integrità di tutte le repliche di disponibilità in un gruppo di disponibilità

PS C:\> Get-ChildItem "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas" | Test-SqlAvailabilityReplica

Questo comando valuta l'integrità di tutte le repliche di disponibilità nel gruppo di disponibilità denominato MainAg e restituisce un breve riepilogo per ogni replica.

Esempio 3: Valutare l'integrità di una replica di disponibilità per ogni criterio PBM

PS C:\> Test-SqlAvailabilityReplica -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas\MainReplica" -ShowPolicyDetails

Questo comando valuta l'integrità della replica di disponibilità denominata MainReplica nel MainAg gruppo di disponibilità e restituisce i risultati della valutazione per ogni criterio PBM eseguito.

Esempio 4: Valutare l'integrità di una replica di disponibilità e includere criteri definiti dall'utente

PS C:\> Test-SqlAvailabilityReplica -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas\MainReplica" -AllowUserPolicies

Questo comando valuta l'integrità della replica di disponibilità denominata MainReplica nel MainAg gruppo di disponibilità. Nella valutazione sono inclusi i criteri definiti dall'utente.

Esempio 5: Visualizzare tutte le repliche di disponibilità in uno stato di errore

PS C:\> Get-ChildItem "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas" | Test-SqlAvailabilityReplica | Where-Object { $_.HealthState -eq "Error" }

Questo comando mostra tutte le repliche di disponibilità con uno stato di integrità del MainAg gruppo di Error disponibilità.

Parametri

-AllowUserPolicies

Indica che questo cmdlet esegue i criteri utente trovati nelle categorie di criteri di Always On.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

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

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Specifica una matrice di repliche di disponibilità da valutare.

Tipo:AvailabilityReplica[]
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-NoRefresh

Indica che questo cmdlet non aggiornerà manualmente gli oggetti specificati dai parametri Path o InputObject .

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Path

Specifica il percorso di una o più repliche di disponibilità. Questo parametro è facoltativo e, Se non specificato, viene utilizzata la posizione di lavoro corrente.

Tipo:String[]
Posizione:1
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ShowPolicyDetails

Indica che viene visualizzato il risultato di ogni valutazione dei criteri eseguita da questo cmdlet. Il cmdlet restituisce un oggetto per ogni valutazione dei criteri. Questo oggetto contiene campi che descrivono i risultati della valutazione.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.SqlServer.Management.Smo.AvailabilityReplica[]