Export-SqlVulnerabilityAssessmentScan
Exporta uma verificação de Avaliação de Vulnerabilidade para um arquivo.
Sintaxe
Default (Padrão)
Export-SqlVulnerabilityAssessmentScan
-ScanResult <ScanResult>
-FolderPath <String>
[-Force]
[<CommonParameters>]
Description
O cmdlet Export-SqlVulnerabilityAssessmentScan exporta uma verificação de Avaliação de Vulnerabilidade para um arquivo. Atualmente, o comando dá suporte à exportação de uma verificação somente para o formato de arquivo do 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.
Exemplos
Exemplo 1: Exportar uma verificação de Avaliação de Vulnerabilidade para o arquivo do Excel
PS C:\> $scanResult = Invoke-SqlVulnerabilityAssessmentScan -ServerInstance "MyComputer\MainInstance" -Database some_database
PS C:\> $scanResult | Export-SqlVulnerabilityAssessmentScan -FolderPath "ScanResult.xlsx"
Neste exemplo, invocamos uma verificação de Avaliação de Vulnerabilidade em um banco de dados e, em seguida, exportamos para um arquivo do Excel.
Exemplo 2: iterar em bancos de dados em alguns servidores e exportar verificações de VA para arquivos do 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
Neste exemplo, mostramos uma maneira simples de verificar rapidamente bancos de dados em um conjunto de SQL Servers (nesse caso, 2 instâncias em execução no computador local). A lista de bancos de dados é filtrada no nome, portanto, somente aqueles cujos nomes começam com "keep_" são verificados). Os resultados são armazenados na pasta TEMP nos arquivos do Excel com um nome que identifica o servidor e os bancos de dados aos quais a verificação se referiu.
Parâmetros
-FolderPath
Onde o arquivo exportado será salvo
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Force
Se será necessário forçar a substituição do arquivo se ele já existir. Se esse parâmetro não estiver presente, você será solicitado antes que a operação continue.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ScanResult
O resultado da verificação de Avaliação de Vulnerabilidade a ser exportado. O resultado da verificação deve conter os metadados das verificações de segurança relevantes.
Propriedades do parâmetro
| Tipo: | ScanResult |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.