Export-SqlVulnerabilityAssessmentScan

Экспортирует проверку оценки уязвимостей в файл.

Синтаксис

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

Описание

Командлет Export-SqlVulnerabilityAssessmentScan экспортирует сканирование оценки уязвимостей в файл. В настоящее время команда поддерживает экспорт только в формат файла Excel (.xlsx).

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

Примеры

Пример 1. Экспорт проверки оценки уязвимостей в файл Excel

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

В этом примере мы вызываем проверку оценки уязвимостей в базе данных, а затем экспортируем ее в файл Excel.

Пример 2. Итерацию по базам данных на некоторых серверах и экспорт проверки va в файлы Excel

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

В этом примере показан простой способ быстрого сканирования баз данных на наборе СЕРВЕРОВ SQL Server (в данном случае 2 экземпляра, запущенных на локальном компьютере). Список баз данных фильтруется по имени, поэтому проверяются только те, имена которых начинаются с "keep_". Результаты хранятся в папке TEMP в файлах Excel с именем, определяющим сервер и базы данных, на которые ссылается проверка.

Параметры

-FolderPath

Место сохранения экспортированного файла

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

-Force

Следует ли принудительно перезаписать файл, если он уже существует. Если этот параметр отсутствует, перед продолжением операции появится запрос.

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

-ScanResult

Результат проверки оценки уязвимостей для экспорта. Результат проверки должен содержать метаданные соответствующих проверок безопасности.

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

Входные данные

Microsoft.SqlServer.VulnerabilityAssessment.ScanResult

Выходные данные

System.Object