Export-SqlVulnerabilityAssessmentScan

Référence

Module:: SQLServer

Exporte une analyse d’évaluation des vulnérabilités dans un fichier.

Syntax

Export-SqlVulnerabilityAssessmentScan
      -ScanResult <ScanResult>
      -FolderPath <String>
      [-Force]
      [<CommonParameters>]

Description

L’applet de commande Export-SqlVulnerabilityAssessmentScan exporte une analyse d’évaluation des vulnérabilités dans un fichier. Actuellement, la commande prend en charge l’exportation d’une analyse au format de fichier Excel (.xlsx) uniquement.

Module requirements: version 21+ on PowerShell 5.1; version 22+ on PowerShell 7.x.

Exemples

Exemple 1 : Exporter une analyse d’évaluation des vulnérabilités dans un fichier Excel

PS C:\> $scanResult = Invoke-SqlVulnerabilityAssessmentScan -ServerInstance "MyComputer\MainInstance" -Database some_database
PS C:\> $scanResult | Export-SqlVulnerabilityAssessmentScan -FolderPath "ScanResult.xlsx"

Dans cet exemple, nous appelons une analyse d’évaluation des vulnérabilités sur une base de données, puis l’exportons vers un fichier Excel.

Exemple 2 : Itérer sur des bases de données sur certains serveurs et exporter des analyses VA vers des fichiers 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

Dans cet exemple, nous affichons un moyen simple d’analyser rapidement les bases de données sur un ensemble de serveurs SQL (dans ce cas, 2 instances s’exécutant sur l’ordinateur local). La liste des bases de données est filtrée sur le nom, de sorte que seuls les noms dont les noms commencent par « keep_ » sont analysés). Les résultats sont stockés sous le dossier TEMP dans les fichiers Excel avec un nom qui identifie le serveur et les bases de données auxquelles l’analyse est référencée.

Paramètres

-FolderPath

Où le fichier exporté sera enregistré

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

-Force

Indique s’il faut forcer le remplacement du fichier s’il existe déjà. Si ce paramètre n’est pas présent, vous serez invité avant la poursuite de l’opération.

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

-ScanResult

Résultat de l’analyse d’évaluation des vulnérabilités à exporter. Le résultat de l’analyse doit contenir les métadonnées des vérifications de sécurité pertinentes.

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

Entrées

Microsoft.SqlServer.VulnerabilityAssessment.ScanResult

Sorties

System.Object

SQLServer_Cmdlets