Partager via


Export-SqlVulnerabilityAssessmentScan

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

Syntaxe

Default (Par défaut)

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 vocons 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 montrons 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. 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é

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ScanResult

Résultat de l’analyse de l’évaluation des vulnérabilités à exporter. Le résultat de l’analyse doit contenir les métadonnées des contrôles de sécurité appropriés.

Propriétés du paramètre

Type:ScanResult
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

Microsoft.SqlServer.VulnerabilityAssessment.ScanResult

Sorties

System.Object