Invoke-SqlAssessment
Menjalankan pemeriksaan praktik terbaik Penilaian SQL untuk objek SQL Server yang dipilih dan mengembalikan hasilnya.
Sintaks
Invoke-SqlAssessment
[-Check <Object[]>]
[[-InputObject] <PSObject>]
[-Configuration <PSObject>]
[-MinSeverity <SeverityLevel>]
[-FlattenOutput]
[<CommonParameters>]
Deskripsi
Cmdlet Invoke-SqlAssessment menjalankan penilaian untuk setiap objek input dan mengembalikan daftar rekomendasi praktik terbaik yang harus diterapkan ke objek yang ditentukan. Terserah Anda untuk mengikuti rekomendasi yang diberikan atau tidak. Untuk informasi selengkapnya, lihat gambaran umum SQL Assessment API.
Cmdlet ini menerima jenis input berikut:
- Microsoft.SqlServer.Management.Smo.Server
- Microsoft.SqlServer.Management.Smo.Database
- Microsoft.SqlServer.Management.Smo.AvailabilityGroup
- Microsoft.SqlServer.Management.Smo.FileGroup
- Microsoft.SqlServer.Management.Smo.RegisteredServers.RegisteredServer
- String yang berisi jalur ke objek apa pun dari jenis di atas
- Kumpulan objek
Anda bisa mendapatkan objek input dengan cmdlet SqlServer seperti cmdlet PowerShell Get-SqlInstance dan Get-SqlDatabase atau dasar seperti Get-Item dan Get-ChildItem. Selain itu, cmdlet mendukung penyedia PowerShell SQL Server, sehingga dapat memperoleh objek dari jalurnya. Jalur dapat dilewati secara eksplisit, jika tidak, jalur saat ini akan digunakan.
Ketersediaan pemeriksaan untuk objek yang dipilih bervariasi pada versi SQL Server, platform, dan jenis objek. Selain itu, ada pemeriksaan yang menargetkan database tertentu seperti tempdb
atau master
. Anda juga dapat memfilter pemeriksaan berdasarkan tag, nama, dan tingkat keparahan dengan parameter -MinSeverity dan -Check.
Anda bisa mendapatkan daftar pemeriksaan yang berlaku untuk objek SQL Server yang diberikan dengan cmdlet Get-SqlAssessmentItem.
Cmdlet hanya menjalankan pemeriksaan yang berlaku untuk objek input. Misalnya, pemeriksaan database tidak akan dijalankan untuk instans SQL Server atau grup ketersediaan, bahkan ketika ditentukan dalam -Check list.
Konfigurasi kustom dapat diterapkan dengan parameter -Configuration. Contoh kustomisasi tersedia di Github.
CATATAN. Di pratinjau publik pertama , Invoke-SqlAssessment menampilkan objek AssessmentNote dengan properti CheckId dan CheckName yang masing-masing berisi ID Periksa dan DisplayName. Di pratinjau publik kedua, kedua properti diganti dengan satu properti Periksa yang menyediakan lebih banyak data. Dengan asumsi $note adalah objek yang dikembalikan oleh Invoke-SqlAssessment, Anda dapat mengakses ID pemeriksaan sebagai $note.Check.Id alih-alih $note. CheckId, atau periksa deskripsi sebagai $note. Check.Description. Anda dapat menggunakan parameter -FlattenOutput untuk mendapatkan hasil dalam format sebelumnya dengan CheckId dan CheckName. Parameter ini juga akan membantu mempertahankan kompatibilitas ke beberapa cmdlet seperti Write-SqlTableData. Lihat contoh 12-14 untuk detail selengkapnya.
Output cmdlet Invoke-SqlAssessment adalah daftar praktik terbaik yang dilanggar untuk setiap objek SQL Server yang diberikan. Gunakan properti Deskripsi untuk mempelajari praktik terbaik dan properti Pesan untuk mengetahui bagaimana hal itu dapat diselesaikan. Selain itu, setiap hasil pemeriksaan berisi tautan ke dokumentasi online, yang akan membantu Anda mengetahui masalah dengan lebih baik.
SQL Server pada dukungan Azure VM
Dengan cmdlet Penilaian SQL, Anda dapat menilai instans SQL Server di Azure VM tidak hanya sebagai SQL Server lokal, tetapi juga dengan aturan yang khusus untuk SQL Server pada Azure VM (yang menggunakan informasi tentang konfigurasi komputer virtual). Misalnya, aturan AzSqlVmSize memeriksa bahwa VM yang menghosting instans SQL Server di Azure VM memiliki ukuran yang direkomendasikan.
Untuk menggunakan aturan tersebut, sambungkan ke Azure dengan Modul Azure PowerShell dan pastikan modul Az.ResourceGraph diinstal.
Masuk dengan Azure PowerShell sebelum memanggil Penilaian SQL terhadap SQL Server pada instans Azure VM. Contoh 16 memperlihatkan proses masuk interaktif dan pemilihan langganan.
CATATAN. Dimungkinkan untuk menggunakan koneksi akun Azure yang bertahan di antara sesi PowerShell, yaitu memanggil Connect-AzAccount dalam satu sesi dan menghilangkan perintah ini nanti. Namun, versi cmdlet Penilaian SQL saat ini memerlukan modul Az.ResourceGraph untuk diimpor secara eksplisit dalam hal ini: Import-Module Az.ResourceGraph
Contoh
Contoh 1: Memanggil penilaian untuk instans default lokal
PS:> Get-SqlInstance -ServerInstance localhost | Invoke-SqlAssessment
TargetPath : Server[@Name='LOCAL']
Sev. Message Check ID Origin
---- ------- -------- ------
Info Enable trace flag 834 to use large-page allocations to improve TF834 Microsoft Ruleset 0.1.202
analytical and data warehousing workloads.
Low Detected deprecated or discontinued feature uses: String literals DeprecatedFeatures Microsoft Ruleset 0.1.202
as column aliases, syscolumns, sysusers, SET FMTONLY ON, XP_API,
Table hint without WITH, More than two-part column name. We
recommend to replace them with features actual for SQL Server
version 14.0.1000.
Medi Amount of single use plans in cache is high (100%). Consider PlansUseRatio Microsoft Ruleset 0.1.202
enabling the Optimize for ad hoc workloads setting on heavy OLTP
ad-hoc workloads to conserve resources.
...
Contoh ini menunjukkan cara mendapatkan semua rekomendasi praktik terbaik untuk instans default SQL Server yang berjalan pada komputer saat ini.
Contoh 2: Memanggil penilaian dengan cmdlet PSProvider
PS:> Get-Item SQLSERVER:\SQL\localhost\default | Invoke-SqlAssessment
TargetPath : Server[@Name='LOCAL']
Sev. Message Check ID Origin
---- ------- -------- ------
Info Enable trace flag 834 to use large-page allocations to improve TF834 Microsoft Ruleset 0.1.202
analytical and data warehousing workloads.
Low Detected deprecated or discontinued feature uses: String literals DeprecatedFeatures Microsoft Ruleset 0.1.202
as column aliases, syscolumns, sysusers, SET FMTONLY ON, XP_API,
Table hint without WITH, More than two-part column name. We
recommend to replace them with features actual for SQL Server
version 14.0.1000.
Medi Amount of single use plans in cache is high (100%). Consider PlansUseRatio Microsoft Ruleset 0.1.202
enabling the Optimize for ad hoc workloads setting on heavy OLTP
ad-hoc workloads to conserve resources.
...
Contoh ini menunjukkan cara mendapatkan semua rekomendasi praktik terbaik untuk instans default SQL Server.
Contoh 3: Memanggil penilaian dengan jalur Penyedia PS
PS:> Invoke-SqlAssessment SQLSERVER:\SQL\localhost\default
TargetPath : Server[@Name='LOCAL']
Sev. Message Check ID Origin
---- ------- -------- ------
Info Enable trace flag 834 to use large-page allocations to improve TF834 Microsoft Ruleset 0.1.202
analytical and data warehousing workloads.
Low Detected deprecated or discontinued feature uses: String literals DeprecatedFeatures Microsoft Ruleset 0.1.202
as column aliases, syscolumns, sysusers, SET FMTONLY ON, XP_API,
Table hint without WITH, More than two-part column name. We
recommend to replace them with features actual for SQL Server
version 14.0.1000.
Medi Amount of single use plans in cache is high (100%). Consider PlansUseRatio Microsoft Ruleset 0.1.202
enabling the Optimize for ad hoc workloads setting on heavy OLTP
ad-hoc workloads to conserve resources.
...
Contoh ini menunjukkan cara mendapatkan semua rekomendasi praktik terbaik untuk instans default SQL Server.
Contoh 4: Memanggil penilaian dengan konfigurasi kustom
PS:> Get-SqlInstance -ServerInstance '(local)' | Invoke-SqlAssessment -Configuration C:\profileA.json, C:\profileB.json
TargetPath : Server[@Name='LOCAL']
Sev. Message Check ID Origin
---- ------- -------- ------
Low Detected deprecated or discontinued feature uses: String literals DeprecatedFeatures Microsoft Ruleset 0.1.202
as column aliases, syscolumns, sysusers, SET FMTONLY ON, XP_API,
Table hint without WITH, More than two-part column name. We
recommend to replace them with features actual for SQL Server
version 14.0.1000.
Medi A custom rule violation detected. CustomRuleA Profile A 1.0
...
Contoh ini menunjukkan cara menerapkan konfigurasi kustom untuk mendapatkan serangkaian rekomendasi praktik terbaik yang dimodifikasi. Konfigurasi kustom dijelaskan dalam file JSON. Aturan kustom profileA.json dan profileB.json menonaktifkan beberapa pemeriksaan dan memperkenalkan beberapa yang baru. Salah satu pemeriksaan baru dari profileA.json mendeteksi masalah dengan konfigurasi instans SQL Server saat ini. Kunjungi folder sampel Penilaian SQL di Github untuk mengetahui cara membuat penyesuaian.
Contoh 5: Memanggil penilaian untuk semua instans
PS:> dir SQLSERVER:\SQL\localhost | Invoke-SqlAssessment
TargetPath : Server[@Name='LOCAL']
Sev. Message Check ID Origin
---- ------- -------- ------
Info Enable trace flag 834 to use large-page allocations to improve TF834 Microsoft Ruleset 0.1.202
analytical and data warehousing workloads.
Low Detected deprecated or discontinued feature uses: String literals DeprecatedFeatures Microsoft Ruleset 0.1.202
as column aliases, syscolumns, sysusers, SET FMTONLY ON, XP_API,
Table hint without WITH, More than two-part column name. We
recommend to replace them with features actual for SQL Server
version 14.0.1000.
Medi Amount of single use plans in cache is high (100%). Consider PlansUseRatio Microsoft Ruleset 0.1.202
enabling the Optimize for ad hoc workloads setting on heavy OLTP
ad-hoc workloads to conserve resources.
TargetPath : Server[@Name='LOCAL\INSTANCE1']
Sev. Message Check ID Origin
---- ------- -------- ------
Medi Product version 14.0.1000 is not the latest available. Keep your LatestCU Microsoft Ruleset 0.1.202
your SQL Server up to date and install Service Packs and
Cumulative Updates as they are released.
...
Contoh ini menunjukkan cmdlet Invoke-SqlAssessment yang menerima serangkaian instans SQL Server melalui alur.
Contoh 6: Menjalankan penilaian untuk traget ot set yang difilter
PS:> Get-SqlInstance -ServerInstance . | Where { $_.Name -Match '.*\d+' } | Invoke-SqlAssessment
TargetPath : Server[@Name='LOCAL\INSTANCE1']
Sev. Message Check ID Origin
---- ------- -------- ------
Medi Product version 14.0.1000 is not the latest available. Keep your LatestCU Microsoft Ruleset 0.1.202
your SQL Server up to date and install Service Packs and
Cumulative Updates as they are released.
...
Contoh ini menunjukkan cmdlet Invoke-SqlAssessment yang menerima serangkaian instans SQL Server melalui alur. Set difilter dengan cmdlet Where-Object PowerShell standar.
Contoh 7: Memanggil penilaian untuk database berdasarkan nama
PS:> Get-SqlDatabase master -ServerInstance localhost | Invoke-SqlAssessment -Verbose
VERBOSE: Base ruleset version: 0.2.
VERBOSE: No recommendations for [master].
Contoh ini memperlihatkan cmdlet Invoke-SqlAssessment yang menerima nama database. Dalam hal ini tidak ditemukan masalah.
Contoh 8: Memanggil penilaian untuk database menurut jalur
PS:> Invoke-SqlAssessment SQLSERVER:\SQL\localhost\default\Databases\master -Verbose
VERBOSE: Base ruleset version: 0.2.
VERBOSE: No recommendations for [master].
Contoh ini memperlihatkan cmdlet Invoke-SqlAssessment yang menerima jalur ke database SQL Server.
Contoh 9: Mendeteksi masalah tinggi untuk database
PS:> cd SQLSERVER:\SQL\localhost\default\Databases\master
PS:> Invoke-SqlAssessment -MinSeverity High
VERBOSE: Base ruleset version: 0.2.
VERBOSE: No recommendations for [master].
Contoh ini menunjukkan cmdlet Invoke-SqlAssessment yang menilai lokasi saat ini. Hanya masalah tinggi yang dilaporkan.
Contoh 10: Jalankan pemeriksaan yang dipilih oleh tag
PS:> Get-SqlInstance -ServerInstance . | Invoke-SqlAssessment -Check Backup -Verbose
VERBOSE: Base ruleset version: 0.2.
VERBOSE: No recommendations for [LOCAL].
Contoh ini menunjukkan cmdlet Invoke-SqlAssessment yang menjalankan semua pemeriksaan terkait cadangan untuk setiap instans SQL Server di server lokal.
Contoh 11: Jalankan pemeriksaan yang dipilih secara interaktif
PS:> $serverInstance = Get-SqlInstance -ServerInstance '(local)'
PS:> $checks = Get-SqlAssessmentItem $serverInstance | Select Name, Description | Out-GridView -PassThru
PS:> Invoke-SqlAssessment $serverInstance -Check $checks
TargetPath : Server[@Name='LOCAL']
Sev. Message Check ID Origin
---- ------- -------- ------
Info Enable trace flag 834 to use large-page allocations to improve TF834 Microsoft Ruleset 0.1.202
analytical and data warehousing workloads.
Low Detected deprecated or discontinued feature uses: String literals DeprecatedFeatures Microsoft Ruleset 0.1.202
as column aliases, syscolumns, sysusers, SET FMTONLY ON, XP_API,
Table hint without WITH, More than two-part column name. We
recommend to replace them with features actual for SQL Server
version 14.0.1000.
Baris kedua dari contoh ini menunjukkan mendapatkan pemeriksaan untuk $serverInstance, dan memilih beberapa di antaranya secara interaktif. Item yang dipilih disimpan dalam variabel array, yang kemudian digunakan sebagai input untuk cmdlet Invoke-SqlAssessment . Hanya pemeriksaan yang dipilih yang dijalankan selama proses penilaian.
Contoh 12: Efek parameter -FlattenOutput
PS> $inst = Get-SqlInstance -ServerInstance .
PS> Invoke-SqlAssessment $inst -FlattenOutput | Select -First 1 | Get-Member
TypeName: Microsoft.SqlServer.Management.Assessment.Cmdlets.AssessmentNoteFlat
Name MemberType Definition
---- ---------- ----------
Equals Method bool Equals(System.Object obj)
GetHashCode Method int GetHashCode()
GetType Method type GetType()
ToString Method string ToString()
CheckId Property string CheckId {get;}
CheckName Property string CheckName {get;}
HelpLink Property string HelpLink {get;}
Message Property string Message {get;}
RulesetName Property string RulesetName {get;}
RulesetVersion Property string RulesetVersion {get;}
Severity Property string Severity {get;}
TargetPath Property string TargetPath {get;}
TargetType Property string TargetType {get;}
PS> Invoke-SqlAssessment $inst | Select -First 1 | Get-Member
TypeName: Microsoft.SqlServer.Management.Assessment.Cmdlets.AssessmentNote
Name MemberType Definition
---- ---------- ----------
Equals Method bool Equals(System.Object obj)
GetHashCode Method int GetHashCode()
GetType Method type GetType()
ToString Method string ToString()
Check Property Microsoft.SqlServer.Management.Assessment.Checks.ICheck Check {get;}
HelpLink Property string HelpLink {get;}
Message Property string Message {get;}
Severity Property Microsoft.SqlServer.Management.Assessment.SeverityLevel Severity {get;}
TargetPath Property string TargetPath {get;}
TargetType Property string TargetType {get;}
PS> (Invoke-SqlAssessment $inst | Select -First 1).Check | Get-Member
TypeName: Microsoft.SqlServer.Management.Assessment.Checks.Check
Name MemberType Definition
---- ---------- ----------
Equals Method bool Equals(System.Object obj)
GetHashCode Method int GetHashCode()
GetType Method type GetType()
ToString Method string ToString()
Condition Property Microsoft.SqlServer.Management.Assessment....
Description Property string Description {get;set;}
DisplayName Property string DisplayName {get;set;}
Enabled Property bool Enabled {get;set;}
HelpLink Property string HelpLink {get;set;}
Id Property string Id {get;set;}
Level Property Microsoft.SqlServer.Management.Assessment....
Message Property string Message {get;set;}
OriginName Property string OriginName {get;set;}
OriginVersion Property version OriginVersion {get;set;}
Parameters Property System.Collections.Generic.IDictionary[str...
Probes Property System.Collections.Generic.List[Microsoft....
Tags Property System.Collections.Generic.HashSet[string]...
Target Property Microsoft.SqlServer.Management.Assessment....
Contoh ini menunjukkan perbedaan antara objek yang dikembalikan dengan atau tanpa parameter -FlattenOutput. Parameter menggantikan objek Periksa kompleks besar dengan dua properti string CheckId dan CheckName. Ini berguna untuk tujuan serialisasi (lihat contoh berikutnya).
Perintah pertama menunjukkan objek sederhana dengan semua properti jenis string.
Perintah kedua menunjukkan objek lain dengan dua properti non-string: Periksa dan Tingkat Keparahan.
Perintah ketiga memperlihatkan kumpulan data kaya yang dapat diakses dengan properti Periksa.
Contoh 13: Jalankan pemeriksaan gagal lagi
PS> $inst = Get-SqlInstance -ServerInstance .
PS> $results = Invoke-SqlAssessment $inst
PS> $results
TargetPath : Server[@Name='LOCAL']
Sev. Message Check ID Origin
---- ------- -------- ------
Info Enable trace flag 834 to use large-page allocations to improve TF834 Microsoft Ruleset 0.1.202
analytical and data warehousing workloads.
Low Detected deprecated or discontinued feature uses: String literals DeprecatedFeatures Microsoft Ruleset 0.1.202
as column aliases, syscolumns, sysusers, SET FMTONLY ON, XP_API,
Table hint without WITH, More than two-part column name. We
recommend to replace them with features actual for SQL Server
version 14.0.1000.
Medi Amount of single use plans in cache is high (100%). Consider PlansUseRatio Microsoft Ruleset 0.1.202
enabling the Optimize for ad hoc workloads setting on heavy OLTP
ad-hoc workloads to conserve resources.
PS> $results[1].Check.Description
This check detects deprecated or discontinued features used on target SQL Server instance. Deprecated features may be
removed in a future release of SQL Server. Discontinued features have been removed from specific versions of SQL Server.
PS> Invoke-SqlAssessment $inst -Check $results[1].Check
TargetPath : Server[@Name='LOCAL']
Sev. Message Check ID Origin
---- ------- -------- ------
Low Detected deprecated or discontinued feature uses: String literals DeprecatedFeatures Microsoft Ruleset 0.1.202
as column aliases, syscolumns, sysusers, SET FMTONLY ON, XP_API,
Table hint without WITH, More than two-part column name. We
recommend to replace them with features actual for SQL Server
version 14.0.1000.
PS> Invoke-SqlAssessment $inst -Check ($results).Check
TargetPath : Server[@Name='LOCAL']
Sev. Message Check ID Origin
---- ------- -------- ------
Info Enable trace flag 834 to use large-page allocations to improve TF834 Microsoft Ruleset 0.1.202
analytical and data warehousing workloads.
Low Detected deprecated or discontinued feature uses: String literals DeprecatedFeatures Microsoft Ruleset 0.1.202
as column aliases, syscolumns, sysusers, SET FMTONLY ON, XP_API,
Table hint without WITH, More than two-part column name. We
recommend to replace them with features actual for SQL Server
version 14.0.1000.
Medi Amount of single use plans in cache is high (100%). Consider PlansUseRatio Microsoft Ruleset 0.1.202
enabling the Optimize for ad hoc workloads setting on heavy OLTP
ad-hoc workloads to conserve resources.
Contoh ini menunjukkan bagaimana Pemeriksaan yang dikembalikan dengan hasil penilaian dapat digunakan kembali. Anda dapat menjalankan ulang pemeriksaan yang menghasilkan AssessmentNotes sebelumnya.
Contoh 14: Menyimpan hasil penilaian ke tabel
PS:> $serverInstance = Get-SqlInstance -ServerInstance '(local)'
PS:> Invoke-SqlAssessment $serverInstance -FlattenOutput |
Write-SqlTableData -ServerInstance localhost -DatabaseName SqlAssessment -SchemaName Assessment -TableName Results -Force
Baris kedua dari contoh ini menunjukkan penggunaan parameter -FlattenOutput dengan cmdlet Write-SqlTableData untuk menyimpan hasil penilaian ke database SQL.
Contoh 15: Tentukan kredensial secara eksplisit
PS> $cred = Get-Credential
PowerShell credential request
Enter your credentials.
User: Administrator
Password for user Administrator: ********
PS> $inst = Get-SqlInstance -ServerInstance 10.0.3.118 -Credential $cred
PS> Invoke-SqlAssessment $inst
TargetPath : Server[@Name='ContosSQL']
Sev. Message Check ID Origin
---- ------- -------- ------
Medi Amount of single use plans in cache is high (100%). Consider PlansUseRatio Microsoft Ruleset 0.1.202
enabling the Optimize for ad hoc workloads setting on heavy OLTP
ad-hoc workloads to conserve resources
Contoh ini menunjukkan cara memanggil Penilaian SQL dengan kredensial yang ditentukan secara eksplisit.
Contoh 16: Memanggil penilaian untuk SQL Server pada instans Azure VM
PS> Connect-AzAccount
PS> Set-Subscription My-Pay-As-You-Go
PS> $cred = Get-Credential
PowerShell credential request
Enter your credentials.
User: Administrator
Password for user Administrator: ********
PS> $inst = Get-SqlInstance -ServerInstance 10.0.3.118 -Credential $cred
PS> Invoke-SqlAssessment $inst
TargetPath : Server[@Name='ContosoAzureSQL']
Sev. Message Check ID Origin
---- ------- -------- ------
Medi Amount of single use plans in cache is high (100%). Consider PlansUseRatio Microsoft Ruleset 0.1.202
enabling the Optimize for ad hoc workloads setting on heavy OLTP
ad-hoc workloads to conserve resources
Info Use memory optimized virtual machine sizes for the best AzSqlVmSize Microsoft Ruleset 0.1.202
performance of SQL Server workloads
Contoh ini menunjukkan cara memanggil penilaian untuk SQL Server pada instans Azure VM.
Koneksi langganan Azure aktif memungkinkan SQL Server pada pemeriksaan terkait Azure VM (AzSqlVmSize dalam contoh ini). Baris pertama tersambung ke akun Azure untuk mendapatkan data dari Azure Resource Graph. Baris kedua bersifat opsional.
Untuk menjalankan pemeriksaan ini, Penilaian SQL memerlukan modul Az.ResourceGraph.
Parameter
-Check
Satu atau beberapa pemeriksaan, periksa ID, atau tag.
Untuk setiap objek pemeriksaan, Invoke-SqlAssessment berjalan yang memeriksa apakah mendukung objek input.
Untuk setiap ID pemeriksaan, Invoke-SqlAssessment menjalankan pemeriksaan yang sesuai apakah mendukung objek input.
Untuk tag, Invoke-SqlAssessment menjalankan pemeriksaan dengan salah satu tag tersebut.
Type: | Object[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Configuration
Menentukan jalur ke file yang berisi konfigurasi kustom. File kustomisasi akan diterapkan ke konfigurasi default dalam urutan yang ditentukan. Cakupan terbatas pada pemanggilan cmdlet ini saja.
Type: | PSObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FlattenOutput
Menunjukkan bahwa cmdlet ini menghasilkan objek sederhana jenis Microsoft.SqlServer.Management.Assessment.Cmdlets.AssessmentNoteFlatalih-alih Microsoft.SqlServer.Management.Assessment.Cmdlets.AssessmentNote.
AssessmentNote reguler yang dikembalikan dari Invoke-SqlAssessment berisi referensi ke objek kompleks lain yang berguna seperti Periksa (lihat contoh 12). Dengan properti Periksa, Anda bisa mendapatkan deskripsi pemeriksaan atau menggunakan kembali pemeriksaan (lihat contoh 13). Tetapi beberapa cmdlet tidak mendukung properti yang kompleks. Misalnya, Write-SqlTableData akan menimbulkan kesalahan saat mencoba menulis AssessmentNote ke database. Untuk menghindari hal ini, Anda dapat menggunakan parameter -FlattenOutput untuk mengganti properti Periksa dengan dua string sederhana: CheckId dan CheckName (lihat contoh 14).
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Menentukan objek SQL Server atau jalur ke objek tersebut. Cmdlet menjalankan penilaian untuk objek ini. Ketika parameter ini dihilangkan, lokasi saat ini digunakan sebagai objek input. Jika lokasi saat ini bukan objek SQL Server yang didukung, cmdlet menandakan kesalahan.
Type: | PSObject |
Aliases: | Target |
Position: | 10 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-MinSeverity
Menentukan tingkat keparahan minimum untuk pemeriksaan yang akan ditemukan. Misalnya, pemeriksaan tingkat Rendah, Sedang, atau Informasi tidak akan dikembalikan ketika -MinSeverity High.
Type: | SeverityLevel |
Aliases: | Severity |
Accepted values: | Information, Low, Medium, High |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
System.String[]
Microsoft.SqlServer.Management.Smo.SqlSmoObject[]
Output
Microsoft.SqlServer.Assessment.Cmdlets.AssessmentNote