Export-SqlVulnerabilityAssessmentScan

Exporta un examen de evaluación de vulnerabilidades a un archivo.

Sintaxis

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

Description

El cmdlet Export-SqlVulnerabilityAssessmentScan exporta un examen de evaluación de vulnerabilidades a un archivo. Actualmente, el comando solo admite la exportación de un examen al formato de archivo de Excel (.xlsx).

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

This cmdlet was removed in v22.3+ of the module.

Ejemplos

Ejemplo 1: Exportación de un examen de evaluación de vulnerabilidades al archivo de Excel

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

En este ejemplo, invocamos un examen de evaluación de vulnerabilidades en una base de datos y, a continuación, lo exportamos a un archivo de Excel.

Ejemplo 2: Iteración de bases de datos en algunos servidores y exportación de exámenes de VA a archivos de 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

En este ejemplo, se muestra una manera sencilla de examinar rápidamente las bases de datos en un conjunto de servidores SQL Server (en este caso, 2 instancias que se ejecutan en el equipo local). La lista de bases de datos se filtra por el nombre, por lo que solo se examinan los nombres cuyos nombres comienzan por "keep_"). Los resultados se almacenan en la carpeta TEMP de los archivos de Excel con un nombre que identifica el servidor y las bases de datos a las que se hace referencia el examen.

Parámetros

-FolderPath

Dónde se guardará el archivo exportado

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Force

Si se va a forzar la sobrescritura del archivo si ya existe. Si este parámetro no está presente, se le pedirá antes de que continúe la operación.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ScanResult

Resultado del examen de evaluación de vulnerabilidades que se va a exportar. El resultado del examen debe contener los metadatos de las comprobaciones de seguridad pertinentes.

Tipo:ScanResult
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Entradas

Microsoft.SqlServer.VulnerabilityAssessment.ScanResult

Salidas

System.Object