Partager via

Export-SqlVulnerabilityAssessmentScan

  • Référence
Module:
SQLServer

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

Syntaxe

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.

This cmdlet was removed in v22.3+ of the module.

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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Entrées

Microsoft.SqlServer.VulnerabilityAssessment.ScanResult

Sorties

System.Object