Condividi tramite

Test-SqlDatabaseReplicaState

  • Riferimento
Modulo:
SQLServer

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

Sintassi

Test-SqlDatabaseReplicaState
    [-ShowPolicyDetails]
    [-AllowUserPolicies]
    [-NoRefresh]
    [[-Path] <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Test-SqlDatabaseReplicaState
    [-ShowPolicyDetails]
    [-AllowUserPolicies]
    [-NoRefresh]
    [-InputObject] <DatabaseReplicaState[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Descrizione

Il cmdlet Test-SqlDatabaseReplicaState valuta l'integrità di un database di disponibilità in tutte le repliche di disponibilità aggiunte SQL Server valutando i criteri di gestione basata sui criteri basati 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 un database di disponibilità

PS C:\> $Path = "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\DatabaseReplicaStates\MainReplica.MainDatabase"
PS C:\> Test-SqlDatabaseReplicaState -Path $Path

Questo comando valuta l'integrità del database di disponibilità denominato MainDatabase nella replica MainReplica di disponibilità nel gruppo MainAg di disponibilità e restituisce un breve riepilogo.

Esempio 2: Valutare l'integrità di tutti i database di disponibilità in un gruppo di disponibilità

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

Questo comando valuta l'integrità di tutti i database di disponibilità nel MainAg gruppo di disponibilità e restituisce un breve riepilogo per ogni database.

Esempio 3: Valutare l'integrità di tutti i database di disponibilità in un gruppo di disponibilità che mostra i risultati della valutazione PBM

PS C:\> Get-ChildItem "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\DatabaseReplicaStates" | Test-SqlDatabaseReplicaState -ShowPolicyDetails

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

Esempio 4: Valutare l'integrità di tutti i database di disponibilità in un gruppo di disponibilità e includere criteri userdefined

PS C:\> Get-ChildItem "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\DatabaseReplicaStates" | Test-SqlDatabaseReplicaState -AllowUserPolicies

Questo comando valuta l'integrità di tutti i database di disponibilità nel MainAg gruppo di disponibilità. Nella valutazione sono inclusi i criteri definiti dall'utente.

Esempio 5: Visualizzare tutti i database di disponibilità in uno stato di integrità degli errori

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

Questo comando mostra tutti i database 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 oggetti di stato del database di disponibilità. Questo cmdlet calcola l'integrità di questi database di disponibilità.

Tipo:DatabaseReplicaState[]
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 uno o più stati del cluster di replica di database del database di disponibilità. Questo parametro è facoltativo. Se non specificato, viene usato il valore della 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 questo cmdlet mostra il risultato di ogni valutazione dei criteri eseguita. Il cmdlet restituisce un oggetto per ogni valutazione dei criteri e i risultati della valutazione sono disponibili nei campi dell'oggetto.

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