Export-SqlVulnerabilityAssessmentScan

Referenz

Modul:: SQLServer

Exportiert eine Überprüfung der Sicherheitsrisiken in eine Datei.

Syntax

Export-SqlVulnerabilityAssessmentScan
      -ScanResult <ScanResult>
      -FolderPath <String>
      [-Force]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Export-SqlVulnerabilityAssessmentScan exportiert eine Überprüfung der Sicherheitsrisiken in eine Datei. Derzeit unterstützt der Befehl den Export einer Überprüfung nur in Excel (.xlsx)-Dateiformat.

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

Beispiele

Beispiel 1: Exportieren einer Sicherheitsrisikenbewertungsüberprüfung in Excel-Datei

PS C:\> $scanResult = Invoke-SqlVulnerabilityAssessmentScan -ServerInstance "MyComputer\MainInstance" -Database some_database
PS C:\> $scanResult | Export-SqlVulnerabilityAssessmentScan -FolderPath "ScanResult.xlsx"

In diesem Beispiel rufen wir eine Überprüfung der Sicherheitsrisikenbewertung in einer Datenbank auf, und exportieren Sie sie dann in eine Excel-Datei.

Beispiel 2: Iterieren von Datenbanken auf einigen Servern und Exportieren von VA-Scans in Excel-Dateien

PS C:\> @('localhost\SQL2016', 'localhost\SQL2017') | 
  Get-SqlDatabase |
  Where-Object { $_.Name -like 'keep_*' } |
  ForEach-Object  {
    Invoke-SqlVulnerabilityAssessmentScan -ServerInstance $_.Parent -Database $_.Name | 
    Export-SqlVulnerabilityAssessmentScan -FolderPath "$($env:TEMP)\$(($_.Parent).Name -replace '\\', '_' )_$($_.Name)_ScanResult.xlsx"
  }

PS C:\> dir "$env:TEMP\*_ScanResult.xlsx"

    Directory: C:\Users\someuser\AppData\Local\Temp

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        10/6/2018   1:19 AM          80050 SQL2016_keep_MDW_ScanResult.xlsx
-a----        10/6/2018   1:19 AM          80355 SQL2017_keep_MyDB_ScanResult.xlsx
-a----        10/6/2018   1:19 AM          79416 SQL2017_Keep_WideWorldImporters_ScanResult.xlsx

In diesem Beispiel zeigen wir eine einfache Möglichkeit, Datenbanken auf einem Satz von SQL Server schnell zu scannen (in diesem Fall 2 Instanzen, die auf dem lokalen Computer ausgeführt werden). Die Liste der Datenbanken wird auf den Namen gefiltert, sodass nur die Namen, deren Namen mit "keep_" beginnen, gescannt werden. Die Ergebnisse werden unter dem TEMP-Ordner in Excel-Dateien mit einem Namen gespeichert, der den Server und die Datenbanken identifiziert, auf die der Scan verwiesen wird.

Parameter

-FolderPath

Wo die exportierte Datei gespeichert wird

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

-Force

Ob die Überschreibung der Datei erzwungen werden soll, wenn sie bereits vorhanden ist. Wenn dieser Parameter nicht vorhanden ist, werden Sie aufgefordert, bevor der Vorgang fortgesetzt wird.

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

-ScanResult

Das Ergebnis der Überprüfung der Sicherheitsrisikenbewertung, die exportiert werden soll. Das Scanergebnis muss die Metadaten der relevanten Sicherheitsüberprüfungen enthalten.

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

Eingaben

Microsoft.SqlServer.VulnerabilityAssessment.ScanResult

Ausgaben

System.Object

SQLServer_Cmdlets