Compartilhar via


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.

Entradas

Microsoft.SqlServer.VulnerabilityAssessment.ScanResult

Saídas

System.Object