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.

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

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

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

-InputObject

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

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

-NoRefresh

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

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

-Path

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

Type:String[]
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-WhatIf

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

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