Test-SqlAvailabilityGroup
Valuta l'integrità di un gruppo di disponibilità.
Sintassi
ByPath (impostazione predefinita).
Test-SqlAvailabilityGroup
[[-Path] <String[]>]
[-ShowPolicyDetails]
[-AllowUserPolicies]
[-NoRefresh]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Test-SqlAvailabilityGroup
[-InputObject] <AvailabilityGroup[]>
[-ShowPolicyDetails]
[-AllowUserPolicies]
[-NoRefresh]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Il cmdlet Test-SqlAvailabilityGroup valuta l'integrità di un gruppo di disponibilità. Questo cmdlet valuta i criteri di gestione basati su criteri di SQL Server. Per eseguire questo cmdlet, è necessario disporre dei diritti utente CONNECT, VIEW SERVER STATE e VIEW ANY DEFINITION.
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à con 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 . Pertanto, visualizza i risultati della valutazione per ogni criterio di gestione basato su criteri che è stato 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 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à con 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 dei gruppi di disponibilità AlwaysOn.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Confirm
Richiede conferma prima di eseguire il cmdlet.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | cfr |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | 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.
Proprietà dei parametri
| Tipo: | AvailabilityGroup[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ByObject
| Posizione: | 2 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-NoRefresh
Indica che non aggiornerà gli oggetti specificati dal parametro Path o InputObject .
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | 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.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ByPath
| Posizione: | 2 |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | 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.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Wi |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.