Test-SqlAvailabilityGroup
Mengevaluasi kesehatan grup ketersediaan.
Sintaks
ByPath (Default)
Test-SqlAvailabilityGroup
[[-Path] <String[]>]
[-ShowPolicyDetails]
[-AllowUserPolicies]
[-NoRefresh]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByObject
Test-SqlAvailabilityGroup
[-InputObject] <AvailabilityGroup[]>
[-ShowPolicyDetails]
[-AllowUserPolicies]
[-NoRefresh]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Deskripsi
Cmdlet Test-SqlAvailabilityGroup mengevaluasi kesehatan grup ketersediaan. Cmdlet ini mengevaluasi kebijakan manajemen berbasis kebijakan SQL Server. Untuk menjalankan cmdlet ini, Anda harus memiliki hak pengguna CONNECT, VIEW SERVER STATE, dan VIEW ANY DEFINITION.
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 tersebut 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 tersebut 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.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Confirm
Meminta konfirmasi sebelum menjalankan cmdlet.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | Cf |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-InputObject
Menentukan array grup ketersediaan, sebagai objek AvailabilityGroup . Cmdlet ini mengevaluasi kesehatan grup ketersediaan yang ditentukan parameter ini.
Properti parameter
| Jenis: | AvailabilityGroup[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
ByObject
| Position: | 2 |
| Wajib: | True |
| Nilai dari alur: | True |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-NoRefresh
Menunjukkan bahwa tidak akan menyegarkan objek yang ditentukan oleh parameter Jalur atau InputObject .
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-Path
Menentukan jalur grup ketersediaan yang dievaluasi cmdlet ini. Jika Anda tidak menentukan parameter ini, cmdlet ini menggunakan lokasi kerja saat ini.
Properti parameter
| Jenis: | String[] |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
ByPath
| Position: | 2 |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | 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 diteruskan atau tidak, nama kebijakan, dan kategori kebijakan.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | None |
| Mendukung wildcard: | False |
| DontShow: | False |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
-WhatIf
Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.
Properti parameter
| Jenis: | SwitchParameter |
| Nilai default: | False |
| Mendukung wildcard: | False |
| DontShow: | False |
| Alias: | wi |
Set parameter
(All)
| Position: | Named |
| Wajib: | False |
| Nilai dari alur: | False |
| Nilai dari alur berdasarkan nama properti: | False |
| Nilai dari argumen yang tersisa: | False |
CommonParameters
Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.