Export-SqlVulnerabilityAssessmentScan

リファレンス

モジュール:: SQLServer

脆弱性評価スキャンをファイルにエクスポートします。

構文

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

説明

Export-SqlVulnerabilityAssessmentScan コマンドレットは、脆弱性評価スキャンをファイルにエクスポートします。現在、このコマンドでは、Excel (.xlsx) ファイル形式へのスキャンのエクスポートのみがサポートされています。

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

例

例 1: 脆弱性評価スキャンを Excel ファイルにエクスポートする

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

この例では、データベースで脆弱性評価スキャンを呼び出し、Excel ファイルにエクスポートします。

例 2: 一部のサーバー上のデータベースを反復処理し、VA スキャンを 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

この例では、一連の SQL Server (この場合はローカルコンピューターで実行されている 2 つのインスタンス) 上のデータベースをすばやくスキャンする簡単な方法を示します。データベースの一覧は名前でフィルター処理されるため、名前が "keep_" で始まるデータベースのみがスキャンされます)。結果は、サーバーとスキャンが参照するデータベースを識別する名前を持つ Excel ファイルの TEMP フォルダーの下に格納されます。

パラメーター

-FolderPath

エクスポートされたファイルを保存する場所

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

-Force

ファイルが既に存在する場合にファイルを強制的に上書きするかどうかを指定します。このパラメーターが存在しない場合は、操作を続行する前にメッセージが表示されます。

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

-ScanResult

エクスポートする脆弱性評価スキャンの結果。スキャン結果には、関連するセキュリティチェックのメタデータが含まれている必要があります。

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

入力

Microsoft.SqlServer.VulnerabilityAssessment.ScanResult

出力

System.Object

SQLServer_Cmdlets