PowerShell解析JSON获取Datadog版本失败：如何选择正确安装端点？

核心问题分析 #

脚本在版本匹配环节存在以下关键问题：

1. 类型不匹配导致匹配失效：$Versions是[version]类型数组，但$SpecificVersion是字符串，直接用-eq比较会触发隐式转换异常，无法正确匹配目标版本。
2. 未处理版本不存在的场景：若指定版本在JSON列表中不存在，脚本会继续执行后续逻辑，导致下载路径为空，最终安装失败。
3. 版本对象转字符串的潜在错误：若-eq意外返回数组（如多版本匹配），$ChosenVersion.ToString()会返回数组类型名称而非版本字符串，导致无法正确访问JSON中的对应属性。

修正后的完整脚本 #

<#
    .SYNOPSIS
    该PowerShell脚本用于在Windows系统上无缝安装指定版本的Datadog Agent

    .PARAMETER APIKey
    Datadog安装所需的API密钥，若没有请联系支持人员获取

    .PARAMETER Location
    MSI安装包的下载路径，默认是C:\Windows\Temp

    .PARAMETER Hostname
    主机名称，默认使用Windows系统主机名

    .PARAMETER SpecificVersion
    要安装的Datadog Agent版本

    .PARAMETER Tags
    要分配给Agent的标签

    .EXAMPLE
    .\Datadog-Installer.ps1 -APIKey INSERTKEYHERE -SpecificVersion 7.47.0 -Tags MyTag1,MyTag2
#>
[CmdletBinding()]
Param(
    [Parameter(Mandatory=$True)]
    [string]   $APIKey,
    [string]   $SpecificVersion,

    [ValidateScript({ Test-Path $_ })]
    [string]   $Location = "C:\Windows\Temp",
    [string]   $Hostname = $env:COMPUTERNAME,
    [string[]] $Tags
)
begin{
    $MSI = Join-Path -Path $Location -ChildPath "ddog.msi"
    If (Test-Path $MSI) {
        Remove-Item $MSI -Force
    }
}
process{
    Write-Output "获取版本列表JSON"
    $InstallerJsonUrl = "https://s3.amazonaws.com/ddagent-windows-stable/installers.json"
    $Req = Invoke-WebRequest -Uri $InstallerJsonUrl

    Write-Output "解析版本信息"
    $VersionsObject = $Req.Content | ConvertFrom-Json
    # 提取所有版本字符串
    $VersionStrings = $VersionsObject.PSObject.Properties | 
                      Where-Object { $_.MemberType -eq 'NoteProperty' } | 
                      Select-Object -ExpandProperty Name

    # 转换为[version]对象数组，便于版本比较
    $Versions = $VersionStrings | ForEach-Object { [version]$_ }

    # 处理版本选择逻辑
    if ($SpecificVersion) {
        # 验证输入的版本格式是否合法
        try {
            $targetVersion = [version]$SpecificVersion
        }
        catch {
            throw "无效的版本格式：$SpecificVersion，请使用x.y.z格式（例如7.47.0）"
        }
        # 查找匹配的版本
        $ChosenVersion = $Versions | Where-Object { $_ -eq $targetVersion }
        if (-not $ChosenVersion) {
            throw "未找到指定版本：$SpecificVersion，可用版本列表：$($VersionStrings -join ', ')"
        }
        $ChosenVersionString = $ChosenVersion.ToString()
    }
    else {
        # 未指定版本时，自动选择最新版本
        $ChosenVersion = $Versions | Sort-Object -Descending | Select-Object -First 1
        $ChosenVersionString = $ChosenVersion.ToString()
        Write-Output "未指定版本，将安装最新版本：$ChosenVersionString"
    }

    Write-Output "准备下载Datadog Agent版本 $ChosenVersionString"
    $TargetMSI = $VersionsObject.$ChosenVersionString.amd64

    # 下载MSI安装包
    Invoke-WebRequest -Uri $TargetMSI -OutFile $MSI

    # 构建安装命令
    $installArgs = @(
        "/qn",
        "/i",
        "`"$MSI`"",
        "APIKEY=`"$APIKEY`"",
        "HOSTNAME=`"$HOSTNAME`""
    )
    if ($Tags) {
        $installArgs += "TAGS=`"$($TAGS -join ",")`""
    }
    $Expression = "msiexec $($installArgs -join ' ')"

    Write-Output "开始安装"
    Write-Verbose "安装命令：$Expression"
    Invoke-Expression $Expression
}

关键修正点说明 #

1. 版本匹配逻辑优化：
   • 先将输入的$SpecificVersion转换为[version]类型，确保类型一致后再匹配
   • 添加版本格式验证和不存在的错误抛出，避免无效输入导致的静默失败
2. 版本字符串提取优化：
   • 使用$VersionsObject.PSObject.Properties直接提取JSON版本属性，比Get-Member更简洁可靠
3. 安装命令构建优化：
   • 使用数组构建安装参数，避免手动转义引号的繁琐，同时提升可读性
4. 路径处理优化：
   • 使用Join-Path处理下载路径，避免因路径格式问题导致的文件操作错误

内容的提问来源于stack exchange，提问作者user9311662