PowerShell で VirusTotal の Web API を使ったファイルの安全性を確認する

# SHA256 ファイルハッシュ値
$hash = "File Hash"

# 取得した API Key
$ApiKey = "Your API Key"

# Web API の URL
$url = "https://www.virustotal.com/vtapi/v2/file/report"

# Invoke-RestMethod に渡す Web API の引数を連想配列にする
$body = @{
    resource = $hash
    apikey = $ApiKey
}

# API を叩く
$Report = Invoke-RestMethod -Method Post -Uri $url -Body $body
echo $Report

############################################################
# ファイルのフルパスを渡してファイルの安全性を確認する
############################################################
function GetVirustotal($FileName){
    # ファイルの有無確認
    if( -not (Test-Path $FileName)){
        echo "$FileName not found."
        exit
    }

    # 取得した VirusTotal API Key
    $ApiKey = "Your API Key"

    # Web API 引数
    $hash = (Get-FileHash -Algorithm SHA256 $FileName).Hash
    $url = "https://www.virustotal.com/vtapi/v2/file/report"

    # 引数を連想配列にする
    $body = @{ resource = $hash; apikey = $ApiKey }

    # Web API を叩く
    $Report = Invoke-RestMethod -Method Post -Uri $url -Body $body

    # DB に存在するかの確認
    if( $Report.response_code -eq 0 ){
        echo "This file is not found in DB."
    }
    else{
        # DB に存在していたので、エンジンごとの検出状態を確認
        $Scans = $Report.scans
        $Engines = $Report.scans | Get-Member -type NoteProperty

        $FoundStatsus = @()
        $NotFoundStatus = @()
        foreach( $Engine in $Engines ){
            if($Engine.Definition -match "detected=(?<detected>.*?); version=(?<version>.*?); result=(?<result>.*?)"){

                # ヒットしたエンジン
                if($Matches.detected -eq "True") {
                    $FoundStatsus += "{0}({1}) - {2}" -f $Engine.Name, $Matches.version, $Matches.result
                }
                # ヒットしなかったエンジン
                else{
                    $NotFoundStatus += "{0} not hit." -f $Engine.Name
                }
            }
        }
        
        echo $FoundStatsus
        echo $NotFoundStatus
        
        echo ""
        
        $EngineTotal = $Report.total
        $HitEngine = $Report.positives
        echo "Hit engine : $HitEngine/$EngineTotal"
        
        $SHA256 = $Report.sha256
        echo "sha256 :     $SHA256"
        
        $Permalink = $Report.permalink
        echo "Permalink :"
        echo "$Permalink"
        
    }
}