Get-SqlAssessmentItem
Ruft die bewährten Methodenüberprüfungen der SQL-Bewertung ab, die für ein ausgewähltes SQL Server-Objekt verfügbar sind.
Syntax
Get-SqlAssessmentItem
[-Check <String[]>]
[[-InputObject] <PSObject>]
[-Configuration <PSObject>]
[-MinSeverity <SeverityLevel>]
[-FlattenOutput]
[-ProgressAction <ActionPreference>]
[<CommonParameters>] Beschreibung
Das cmdlet Get-SqlAssessmentItem cmdlet findet alle verfügbaren Best Practice-Überprüfungen für jedes Eingabeobjekt. Weitere Informationen finden Sie in der übersicht über die SQL Assessment API.
Dieses Cmdlet akzeptiert die folgenden Eingabetypen:
- 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
- Zeichenfolge, die Pfad zu einem beliebigen Objekt der obigen Typen enthält
- Auflistung von Objekten
Sie können Eingabeobjekte mit SqlServer-Cmdlets wie Get-SqlInstance und Get-SqlDatabase oder einfache PowerShell abrufen.
Cmdlets wie Get-Item und Get-ChildItem. Außerdem unterstützt das Cmdlet den SQL Server PowerShell-Anbieter, sodass es ein Objekt aus seinem Pfad abrufen kann. Der Pfad kann explizit übergeben werden, andernfalls wird der aktuelle Pfad verwendet.
Die Verfügbarkeit einer Überprüfung für ein ausgewähltes Objekt variiert je nach SQL Server-Version, Plattform und Objekttyp. Außerdem gibt es Überprüfungen, die auf bestimmte Datenbanken wie tempdb oder masterabzielen. Darüber hinaus können Sie Überprüfungen nach Tags, Namen und Schweregrad mit den Parametern -MinSeverity und -Check filtern.
Mit Get-SqlAssessmentItem--Cmdlet können Sie eine Liste der Prüfungen abrufen, die für das angegebene SQL Server-Objekt gelten. Außerdem können Sie die Ausgabe dieses Cmdlets als -Check Argument für Invoke-SqlAssessment Cmdlet verwenden.
Benutzerdefinierte Konfigurationen können mit dem parameter -Configuration angewendet werden. Anpassungsbeispiele sind auf Githubverfügbar.
Unterstützung von SQL Server auf Azure-VM
Mit SQL Assessment-Cmdlets können Sie eine Instanz von SQL Server auf Azure VM nicht nur als lokalen SQL Server bewerten, sondern auch mit Regeln, die für SQL Server auf Azure VM spezifisch sind (diejenigen, die Informationen zur Konfiguration des virtuellen Computers verwenden). Die AzSqlVmSize-Regel überprüft beispielsweise, ob der virtuelle Computer, der eine Instanz von SQL Server auf azure VM hostet, von der empfohlenen Größe ist.
Um solche Regeln zu verwenden, stellen Sie eine Verbindung mit Azure mit Azure PowerShell-Modul her, und stellen Sie sicher, dass das Az.ResourceGraph Modul installiert ist.
Melden Sie sich mit Azure PowerShell an, bevor Sie die SQL-Bewertung für eine SQL Server-Instanz in Azure VM aufrufen. Beispiel 13 zeigt den interaktiven Anmeldevorgang und die Abonnementauswahl.
ANMERKUNG. Es ist möglich, zwischen PowerShell-Sitzungen gespeicherte Azure-Kontoverbindung zu verwenden, d. h. Connect-AzAccount in einer Sitzung aufzurufen und diesen Befehl später auszulassen. Die aktuelle Version von SQL Assessment-Cmdlets benötigt jedoch das Az.ResourceGraph-Modul explizit in diesem Fall zu importieren: Import-Module Az.ResourceGraph
Beispiele
Beispiel 1: Abrufen von Prüfungen auf lokale Standardinstanz
PS:> Get-SqlInstance -ServerInstance 'localhost' | Get-SqlAssessmentItem
Target: [LOCAL]
ID ON Name Origin
-- -- ---- ------
TF1204 True TF 1204 returns deadlock information Microsoft Ruleset 0.1.202
BlackboxTrace True Blackbox trace is configured and running Microsoft Ruleset 0.1.202
HintsStatistics True Hints are being used Microsoft Ruleset 0.1.202
PlansUseRatio True Amount of single use plans in cache i... Microsoft Ruleset 0.1.202
TempDBFilesAutoGrowth True Some TempDB data files have different... Microsoft Ruleset 0.1.202
CpuUtil90 True CPU usage over 90% Microsoft Ruleset 0.1.202
...In diesem Beispiel werden alle Überprüfungen für die Standardinstanz von SQL Server abgerufen, die auf dem aktuellen Computer ausgeführt wird.
Beispiel 2: Abrufen von Prüfungen mit Get-Item Cmdlet
PS:> Get-Item SQLSERVER:\SQL\localhost\default | Get-SqlAssessmentItem
Target: [LOCAL]
ID ON Name Origin
-- -- ---- ------
TF1204 True TF 1204 returns deadlock information Microsoft Ruleset 0.1.202
BlackboxTrace True Blackbox trace is configured and running Microsoft Ruleset 0.1.202
HintsStatistics True Hints are being used Microsoft Ruleset 0.1.202
PlansUseRatio True Amount of single use plans in cache i... Microsoft Ruleset 0.1.202
TempDBFilesAutoGrowth True Some TempDB data files have different... Microsoft Ruleset 0.1.202
CpuUtil90 True CPU usage over 90% Microsoft Ruleset 0.1.202
...In diesem Beispiel werden alle Überprüfungen für die Standardinstanz von SQL Server abgerufen, die auf dem aktuellen Computer ausgeführt wird.
Beispiel 3: Abrufen von Prüfungen mit Dem Pfad zum Zielobjekt
PS:> Get-SqlAssessmentItem SQLSERVER:\SQL\localhost\default
Target: [LOCAL]
ID ON Name Origin
-- -- ---- ------
TF1204 True TF 1204 returns deadlock information Microsoft Ruleset 0.1.202
BlackboxTrace True Blackbox trace is configured and running Microsoft Ruleset 0.1.202
HintsStatistics True Hints are being used Microsoft Ruleset 0.1.202
PlansUseRatio True Amount of single use plans in cache i... Microsoft Ruleset 0.1.202
TempDBFilesAutoGrowth True Some TempDB data files have different... Microsoft Ruleset 0.1.202
CpuUtil90 True CPU usage over 90% Microsoft Ruleset 0.1.202
...In diesem Beispiel werden alle Überprüfungen für die Standardinstanz von SQL Server abgerufen, die auf dem aktuellen Computer ausgeführt wird.
Beispiel 4: Abrufen von Prüfungen mit angewendeter benutzerdefinierter Konfiguration
PS:> Get-SqlDatabase master -ServerInstance . |
Get-SqlAssessmentItem -Configuration C:\rulesetA.json, D:\rulesetB.json
Target: [LOCAL]
ID ON Name Origin
-- -- ---- ------
TF1204 False TF 1204 returns deadlock information Microsoft Ruleset 0.1.202
BlackboxTrace True Blackbox trace is configured and running Microsoft Ruleset 0.1.202
HintsStatistics True Hints are being used Microsoft Ruleset 0.1.202
PlansUseRatio True Amount of single use plans in cache i... Microsoft Ruleset 0.1.202
TempDBFilesAutoGrowth False Some TempDB data files have different... Microsoft Ruleset 0.1.202
CpuUtil90 True CPU usage over 90% Microsoft Ruleset 0.1.202
SomeCustomCheck True Some custom check Ruleset A 1.0
AnotherCustomCheck True Another custom check Ruleset B 1.0
...In diesem Beispiel werden alle verfügbaren Prüfungen mit angewendeter benutzerdefinierter Konfiguration abgerufen, die aus angegebenen JSON-Dateien abgerufen wurden. Besuchen Sie Sql Assessment-Beispielordner auf Github, um herauszufinden, wie Anpassungen vorgenommen werden.
Beispiel 5: Abrufen von Prüfungen für alle Instanzen auf "localhost"
PS:> Get-SqlInstance -ServerInstance localhost | Get-SqlAssessmentItem
Target: [LOCAL]
ID ON Name Origin
-- -- ---- ------
TF1204 True TF 1204 returns deadlock information Microsoft Ruleset 0.1.202
BlackboxTrace True Blackbox trace is configured and running Microsoft Ruleset 0.1.202
CpuUtil90 True CPU usage over 90% Microsoft Ruleset 0.1.202
Target: [LOCAL\INSTANCE1]
ID ON Name Origin
-- -- ---- ------
HintsStatistics True Hints are being used Microsoft Ruleset 0.1.202
PlansUseRatio True Amount of single use plans in cache i... Microsoft Ruleset 0.1.202
TempDBFilesAutoGrowth True Some TempDB data files have different... Microsoft Ruleset 0.1.202
CpuUtil90 True CPU usage over 90% Microsoft Ruleset 0.1.202
...Dieses Beispiel zeigt Get-SqlAssessmentItem Cmdlet, das eine Reihe von SQL Server-Instanzen über pipeline akzeptiert.
Beispiel 6: Abrufen von Prüfungen für alle Instanzen mit Namen, die mit Zahlen enden
PS:> Get-SqlInstance -ServerInstance localhost | Where { $_.Name -Match '.*\d+' } | Get-SqlAssessmentItem
Target: [LOCAL\INSTANCE1]
ID ON Name Origin
-- -- ---- ------
HintsStatistics True Hints are being used Microsoft Ruleset 0.1.202
PlansUseRatio True Amount of single use plans in cache i... Microsoft Ruleset 0.1.202
TempDBFilesAutoGrowth True Some TempDB data files have different... Microsoft Ruleset 0.1.202
CpuUtil90 True CPU usage over 90% Microsoft Ruleset 0.1.202
...Dieses Beispiel zeigt Get-SqlAssessmentItem Cmdlet, das eine Reihe von SQL Server-Instanzen über pipeline akzeptiert. Es werden nur Instanzen verarbeitet, in denen der Name mit Ziffern endet.
Beispiel 7: Abrufen von Überprüfungen für eine Datenbank nach Pfad
PS:> Get-SqlAssessmentItem SQLSERVER:\SQL\localhost\default\Databases\master
TargetObject: [master]
ID ON Name Origin
-- -- ---- ------
AutoCreateStats True Auto-Create Statistics should be on Microsoft Ruleset 0.1.202
HintsUsageInModules False Hints usage in modules Microsoft Ruleset 0.1.202
FullBackup True Full backup is missed or outdated Microsoft Ruleset 0.1.202
DuplicateIndexes True Duplicate Indexes Microsoft Ruleset 0.1.202
RedundantIndexes True Redundant Indexes Microsoft Ruleset 0.1.202
...Dieses Beispiel zeigt Get-SqlAssessmentItem Cmdlet, das einen Pfad zu einer SQL Server-Datenbank akzeptiert.
Beispiel 8: Abrufen von Überprüfungen mit hohem Schweregrad für eine Datenbank
PS:> cd SQLSERVER:\SQL\localhost\default\Databases\master
PS:> Get-SqlAssessmentItem -MinSeverity HighDieses Beispiel zeigt Get-SqlAssessmentItem die verfügbaren Prüfungen mit hohem Schweregrad für die Masterdatenbank zurückgeben. Er akzeptiert den aktuellen PowerShell-Anbieterspeicherort als Ziel.
Beispiel 9: Abrufen von Überprüfungen mit hohem Schweregrad für eine Datenbank
PS:> $db = Get-SqlDatabase master -ServerInstance localhost
PS:> Get-SqlAssessmentItem $db -MinSeverity HighDieses Beispiel zeigt Get-SqlAssessmentItem die verfügbaren Prüfungen mit hohem Schweregrad für die Masterdatenbank zurückgeben.
Beispiel 10: Abrufen von Prüfungen nach Tag
PS:> Get-SqlDatabase -ServerInstance . | Get-SqlAssessmentItem -Check Backup
TargetObject: [master]
ID ON Name Origin
-- -- ---- ------
FullBackup True Full backup is missed or outdated Microsoft Ruleset 0.1.202
TargetObject: [msdb]
ID ON Name Origin
-- -- ---- ------
FullBackup True Full backup is missed or outdated Microsoft Ruleset 0.1.202Dieses Beispiel zeigt Get-SqlAssessmentItem- Cmdlet, das alle Sicherungsüberprüfungen für alle Datenbanken in der lokalen SQL Server-Standardinstanz zurückgibt.
Beispiel 11: Ausführen interaktiv ausgewählter Prüfungen
PS:> $serverInstance = Get-SqlInstance -ServerInstance '(local)'
PS:> $checks = Get-SqlAssessmentItem $serverInstance | Select Id, 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.In der zweiten Zeile dieses Beispiels wird das Abrufen von Überprüfungen für eine $serverInstance und die interaktive Auswahl einiger davon veranschaulicht. Ausgewählte Elemente werden in einer Arrayvariablen gespeichert, die dann als Eingabe für Invoke-SqlAssessment Cmdlet verwendet werden kann. In diesem Fall werden nur ausgewählte Prüfungen während des Bewertungsprozesses ausgeführt.
Beispiel 12: Explizite Angabe von Anmeldeinformationen
PS> $cred = Get-Credential
PowerShell credential request
Enter your credentials.
User: Administrator
Password for user Administrator: ********
PS> $db = Get-SqlDatabase master -ServerInstance 10.0.3.118 -Credential $cred
PS> Get-SqlAssessmentItem $db
TargetObject: [master]
ID ON Name Origin
-- -- ---- ------
AutoCreateStats True Auto-Create Statistics should be on Microsoft Ruleset 0.1.202
FullBackup True Full backup is missed or outdated Microsoft Ruleset 0.1.202
DuplicateIndexes True Duplicate Indexes Microsoft Ruleset 0.1.202
RedundantIndexes True Redundant Indexes Microsoft Ruleset 0.1.202
...In diesem Beispiel wird gezeigt, wie Sie die SQL-Bewertungsüberprüfungsliste mit explizit angegebenen Anmeldeinformationen abrufen.
Beispiel 13: Abrufen der SQL-Bewertungsregelliste für die SQL Server auf azure VM-Instanz
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> Get-SqlAssessmentItem $inst
TargetObject: [ContosoAzureSql]
ID ON Name Origin
-- -- ---- ------
HintsStatistics True Hints are being used Microsoft Ruleset 0.1.202
PlansUseRatio True Amount of single use plans in cache i... Microsoft Ruleset 0.1.202
TempDBFilesAutoGrowth True Some TempDB data files have different... Microsoft Ruleset 0.1.202
AzSqlVmSize True VM size is not memory-optimized Microsoft Ruleset 0.1.202
...In diesem Beispiel wird gezeigt, wie Sie eine Liste der Regeln abrufen, die für eine bestimmte SQL Server-Instanz auf azure VM-Instanz gelten.
Eine aktive Azure-Abonnementverbindung ermöglicht Azure-bezogene Prüfungen (AzSqlVmSize in diesem Beispiel). Die erste Zeile stellt eine Verbindung mit einem Azure-Konto her, um Daten aus Azure Resource Graph abzurufen. Die zweite Zeile ist optional.
Zum Ausführen dieser Prüfungen erfordert die SQL-Bewertung das Az.ResourceGraph-Modul.
Parameter
-Check
Mindestens eine Überprüfung, überprüfung von IDs oder Tags.
Für jedes Überprüfungsobjekt gibt Get-SqlAssessmentItem- diese Überprüfung zurück, wenn es das Eingabeobjekt unterstützt.
Für jede Prüf-ID gibt Get-SqlAssessmentItem- die entsprechende Überprüfung zurück, wenn sie das Eingabeobjekt unterstützt.
Bei Tags gibt Get-SqlAssessmentItem- Überprüfungen mit einem dieser Tags zurück.
| Typ: | String[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Configuration
Gibt Pfade zu Dateien an, die eine benutzerdefinierte Konfiguration enthalten. Anpassungsdateien werden in der angegebenen Reihenfolge auf die Standardkonfiguration angewendet. Der Bereich ist nur auf diesen Cmdlet-Aufruf beschränkt.
| Typ: | PSObject |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-FlattenOutput
Gibt an, dass dieses Cmdlet einfache Objekte vom Typ Microsoft.SqlServer.Management.Assessment.Cmdlets.AssessmentNoteFlat statt Microsoft.SqlServer.Management.Assessment.Cmdlets.AssessmentNote.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-InputObject
Gibt ein SQL Server-Objekt oder einen Pfad zu einem solchen Objekt an. Das Cmdlet gibt geeignete Überprüfungen für dieses Objekt zurück. Wenn dieser Parameter nicht angegeben wird, wird die aktuelle Position als Eingabeobjekt verwendet. Wenn der aktuelle Speicherort kein unterstütztes SQL Server-Objekt ist, signalisiert das Cmdlet einen Fehler.
| Typ: | PSObject |
| Aliase: | Target |
| Position: | 10 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-MinSeverity
Gibt den Mindestschweregrad für zu findende Prüfungen an. Beispielsweise werden Die Überprüfungen der Ebenen "Mittel", "Niedrig" oder "Informationen" nicht zurückgegeben, wenn -MinSeverity "Hoch" zurückgegeben werden.
| Typ: | SeverityLevel |
| Aliase: | Severity |
| Zulässige Werte: | Information, Low, Medium, High |
| Position: | Named |
| Standardwert: | Information |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ProgressAction
Bestimmt, wie PowerShell auf Statusaktualisierungen reagiert, die von einem Skript, Cmdlet oder Anbieter generiert werden, z. B. auf die Statusanzeigen, die vom Cmdlet Write-Progress generiert werden. Das Cmdlet Write-Progress erstellt Statusanzeigen, die den Status eines Befehls anzeigen.
| Typ: | ActionPreference |
| Aliase: | proga |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Eingaben
System.String[]
Microsoft.SqlServer.Management.Smo.SqlSmoObject[]
Ausgaben
Microsoft.SqlServer.Management.Assessment.ICheck