Bagikan melalui

Test-SqlAvailabilityReplica

Modul:
SqlServer

Mengevaluasi kesehatan replika ketersediaan.

Sintaks

Test-SqlAvailabilityReplica
    [-ShowPolicyDetails]
    [-AllowUserPolicies]
    [-NoRefresh]
    [[-Path] <String[]>]
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Test-SqlAvailabilityReplica
    [-ShowPolicyDetails]
    [-AllowUserPolicies]
    [-NoRefresh]
    [-InputObject] <AvailabilityReplica[]>
    [-AccessToken <PSObject>]
    [-TrustServerCertificate]
    [-HostNameInCertificate <String>]
    [-Encrypt <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Deskripsi

Cmdlet Test-SqlAvailabilityReplica menilai kesehatan replika ketersediaan dengan mengevaluasi kebijakan manajemen berbasis kebijakan (PBM) SQL Server. Anda harus memiliki CONNECTizin , VIEW SERVER STATE, dan VIEW ANY DEFINITION untuk menjalankan cmdlet ini.

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

Contoh

Contoh 1: Mengevaluasi kesehatan replika ketersediaan

PS C:\> Test-SqlAvailabilityReplica -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas\MainReplica"

Perintah ini mengevaluasi kesehatan replika ketersediaan bernama MainReplica dalam MainAg grup ketersediaan dan menghasilkan ringkasan singkat.

Contoh 2: Mengevaluasi kesehatan semua replika ketersediaan dalam grup ketersediaan

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

Perintah ini mengevaluasi kesehatan semua replika ketersediaan dalam grup ketersediaan bernama MainAg dan menghasilkan ringkasan singkat untuk setiap replika.

Contoh 3: Mengevaluasi kesehatan replika ketersediaan untuk setiap kebijakan PBM

PS C:\> Test-SqlAvailabilityReplica -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas\MainReplica" -ShowPolicyDetails

Perintah ini mengevaluasi kesehatan replika ketersediaan yang dinamai MainReplica dalam MainAg grup ketersediaan dan menghasilkan hasil evaluasi untuk setiap kebijakan PBM yang dijalankan.

Contoh 4: Mengevaluasi kesehatan replika ketersediaan dan menyertakan kebijakan yang ditentukan pengguna

PS C:\> Test-SqlAvailabilityReplica -Path "SQLSERVER:\Sql\Computer\Instance\AvailabilityGroups\MainAg\AvailabilityReplicas\MainReplica" -AllowUserPolicies

Perintah ini mengevaluasi kesehatan replika ketersediaan yang dinamai MainReplicaMainAg dalam grup ketersediaan. Kebijakan yang ditentukan pengguna disertakan dalam evaluasi ini.

Contoh 5: Menampilkan semua replika ketersediaan yang berada dalam status kesalahan

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

Perintah ini menunjukkan semua replika ketersediaan dengan status Error kesehatan dalam MainAg grup ketersediaan.

Parameter

-AccessToken

Token akses yang digunakan untuk mengautentikasi ke SQL Server, sebagai alternatif untuk pengguna/kata sandi atau Autentikasi Windows.

Ini dapat digunakan, misalnya, untuk menyambungkan dan SQL Azure DBSQL Azure Managed Instance menggunakan Service Principal atau Managed Identity (lihat referensi di bagian bawah halaman ini)

Dalam skenario umum, parameter ini diperoleh dengan sesuatu seperti (Get-AzAccessToken -ResourceUrl https://database.windows.net).Token (memerlukan modul Az.Accounts)

Jenis parameter dapat berupa string (token teks bersih) atau SecureString (token terenkripsi, seperti yang dikembalikan oleh versi cmdlet Get-AzAccessToken yang lebih baru.)

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

-AllowUserPolicies

Menunjukkan bahwa cmdlet ini menjalankan kebijakan pengguna yang ditemukan dalam kategori kebijakan AlwaysOn.

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

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

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

-Encrypt

Jenis enkripsi yang akan digunakan saat menyambungkan ke SQL Server.

Nilai ini memetakan ke Encrypt properti SqlConnectionEncryptOption pada objek SqlConnection dari driver Microsoft.Data.SqlClient.

Dalam v22 modul, defaultnya adalah Optional (untuk kompatibilitas dengan v21). Dalam v23+ modul, nilai defaultnya adalah 'Wajib', yang dapat membuat perubahan yang melanggar untuk skrip yang ada.

Parameter ini baru dalam v22 modul.

Jenis:String
Nilai yang diterima:Mandatory, Optional, Strict
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-HostNameInCertificate

Nama host yang akan digunakan dalam memvalidasi sertifikat SQL Server TLS/SSL. Anda harus meneruskan parameter ini jika instans SQL Server Anda diaktifkan untuk Enkripsi Paksa dan Anda ingin terhubung ke instans menggunakan nama host/nama pendek. Jika parameter ini dihilangkan, maka meneruskan Nama Domain yang Sepenuhnya Memenuhi Syarat (FQDN) ke -ServerInstance diperlukan untuk terhubung ke instans SQL Server yang diaktifkan untuk Enkripsi Paksa.

Parameter ini baru dalam v22 modul.

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

-InputObject

Menentukan array replika ketersediaan untuk dievaluasi.

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

-NoRefresh

Menunjukkan bahwa cmdlet ini tidak akan menyegarkan objek yang ditentukan secara manual 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 ke satu atau beberapa replika ketersediaan. Parameter ini bersifat opsional. Jika tidak ditentukan, lokasi kerja saat ini digunakan.

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

-ShowPolicyDetails

Menunjukkan bahwa hasil setiap evaluasi kebijakan yang dilakukan oleh cmdlet ini ditampilkan. Cmdlet menghasilkan satu objek per evaluasi kebijakan. Objek ini berisi bidang yang menjelaskan hasil evaluasi.

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

-TrustServerCertificate

Menunjukkan apakah saluran akan dienkripsi saat melewati rantai sertifikat untuk memvalidasi kepercayaan.

Dalam v22 modul, defaultnya adalah $true (untuk kompatibilitas dengan v21). Dalam v23+ modul, nilai defaultnya adalah '$false', yang dapat membuat perubahan yang melanggar untuk skrip yang ada.

Parameter ini baru dalam v22 modul.

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

-WhatIf

Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. 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.AvailabilityReplica[]