Bagikan melalui

Test-SqlAvailabilityGroup

  • Referensi
Modul:
SQLServer

Mengevaluasi kesehatan grup ketersediaan.

Sintaks

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

Deskripsi

Cmdlet Test-SqlAvailabilityGroup mengevaluasi kesehatan grup ketersediaan. Cmdlet ini mengevaluasi SQL Server kebijakan manajemen berbasis kebijakan. Untuk menjalankan cmdlet ini, Anda harus memiliki CONNECThak pengguna , VIEW SERVER STATE, dan VIEW ANY DEFINITION .

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

Contoh

Contoh 1: Mengevaluasi kesehatan grup ketersediaan

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

Perintah ini mengevaluasi kesehatan grup ketersediaan bernama MainAG. Perintah mengembalikan ringkasan.

Contoh 2: Mengevaluasi kesehatan semua grup ketersediaan

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

Perintah ini mendapatkan semua grup ketersediaan yang memiliki replika ketersediaan di lokasi yang ditentukan di penyedia SQLSERVER: . Perintah meneruskannya ke cmdlet saat ini dengan menggunakan operator alur. Cmdlet itu mengevaluasi kesehatan setiap grup ketersediaan.

Contoh 3: Menampilkan hasil untuk setiap kebijakan grup ketersediaan

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

Perintah ini mengevaluasi kesehatan grup ketersediaan bernama MainAG. Perintah ini menentukan parameter ShowPolicyDetails. Oleh karena itu, ini menampilkan hasil evaluasi untuk setiap kebijakan manajemen berbasis kebijakan yang berjalan.

Contoh 4: Menampilkan hasil untuk kebijakan yang ditentukan pengguna dari grup ketersediaan

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

Perintah ini mengevaluasi kesehatan grup ketersediaan bernama MainAG. Perintah ini mencakup kebijakan yang ditentukan pengguna dalam evaluasi ini.

Contoh 5: Mendapatkan grup yang memiliki status kesalahan

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

Perintah ini mendapatkan semua grup ketersediaan yang memiliki replika ketersediaan di lokasi yang ditentukan di penyedia SQLSERVER: . Perintah meneruskannya ke cmdlet saat ini dengan menggunakan operator alur. Cmdlet itu mengevaluasi kesehatan setiap grup ketersediaan. Perintah meneruskan hasil tersebut ke cmdlet Where-Object , yang mengembalikan hasil berdasarkan properti HealthState .

Parameter

-AllowUserPolicies

Menunjukkan bahwa cmdlet ini menguji kebijakan pengguna yang ditemukan dalam kategori kebijakan Grup Ketersediaan AlwaysOn.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Jenis:SwitchParameter
Alias:cf
Position:Named
Nilai default:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-InputObject

Menentukan array grup ketersediaan, sebagai objek AvailabilityGroup. Cmdlet ini mengevaluasi kesehatan grup ketersediaan yang ditentukan parameter ini.

Jenis:AvailabilityGroup[]
Position:1
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-NoRefresh

Menunjukkan bahwa tidak akan menyegarkan objek yang ditentukan oleh parameter Path atau InputObject .

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Path

Menentukan jalur grup ketersediaan yang dievaluasi cmdlet ini. Jika Anda tidak menentukan parameter ini, cmdlet ini menggunakan lokasi kerja saat ini.

Jenis:String[]
Position:1
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ShowPolicyDetails

Menunjukkan bahwa cmdlet ini menampilkan hasil setiap evaluasi kebijakan yang dilakukannya. Cmdlet mengembalikan satu objek per evaluasi kebijakan. Setiap objek kebijakan mencakup hasil evaluasi. Informasi ini mencakup apakah kebijakan lulus atau tidak, nama kebijakan, dan kategori kebijakan.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Jenis:SwitchParameter
Alias:wi
Position:Named
Nilai default:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Input

Microsoft.SqlServer.Management.Smo.AvailabilityGroup[]