Export-SqlVulnerabilityAssessmentScan

Referencia

Módulo:: SQLServer

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

Syntax

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.

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

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

Entradas

Microsoft.SqlServer.VulnerabilityAssessment.ScanResult

Salidas

System.Object

SQLServer_Cmdlets