Compartir a través de


Export-SqlVulnerabilityAssessmentScan

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

Sintaxis

Default (Es el valor predeterminado).

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, se invoca un examen de evaluación de vulnerabilidades en una base de datos y, a continuación, se exporta 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

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:ScanResult
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

Microsoft.SqlServer.VulnerabilityAssessment.ScanResult

Salidas

System.Object