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.