PowerShell自动化安装AWS CLI并从S3复制文件（已解决）

2025-02-06 03:21:10

PowerShell自动化安装AWS CLI并从S3复制文件的解决方案

遇到的一个常见问题是，尝试使用PowerShell脚本自动化安装AWS CLI以及从Amazon S3存储桶下载文件到Windows服务器时，可能会遇到AWS CLI命令无法识别的情况。尽管在脚本中安装和配置了AWS CLI，但在后续操作（例如下载S3文件）时，PowerShell会话可能无法识别aws命令。

问题根源分析：

这个问题的核心在于环境变量和会话刷新。安装程序通常会将AWS CLI添加到系统的PATH环境变量中，允许你在任何终端窗口中运行aws命令。但是，脚本的执行环境可能没有立即更新这些环境变量，因此在同一脚本中后续执行aws命令时会失败。另外，虽然环境变量配置完成，但在没有刷新PowerShell会话的情况下，新的会话才能加载到配置完成后的环境变量，当前脚本也因此找不到aws命令。

以下介绍几种解决方案。

解决方案1：刷新环境变量

最直接的解决方法是确保PowerShell会话在安装AWS CLI后刷新其环境变量。这可以通过以下步骤完成：

安装AWS CLI后，重新加载环境变量。
这可以通过使用$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")实现。此命令强制PowerShell会话重新读取环境变量，包括由AWS CLI安装程序添加的aws可执行文件路径。

function Ensure-AWSCLIInstalled {
    # ... 安装AWS CLI的代码 ...

    # 刷新环境变量
    Write-Host "Refreshing environment variables..."
    $env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
    Write-Host "Environment variables refreshed."
}

验证aws命令是否可用。 在刷新环境变量后，添加一个简单的检查来确认aws命令现在是否可被识别。

    if (Get-Command aws -ErrorAction SilentlyContinue) {
        Write-Host "AWS CLI is now recognized."
    } else {
        Write-Error "AWS CLI still not recognized after refreshing environment variables."
        throw "AWS CLI not available. Please check installation and environment variables."
    }

解决方案2：使用完整的AWS CLI路径

另一个方法是避免依赖于PATH环境变量，直接使用AWS CLI可执行文件的完整路径。这确保了PowerShell可以找到aws命令，而无需考虑环境变量是否已正确更新。

确定AWS CLI的安装路径。 默认情况下，AWS CLI安装在C:\Program Files\Amazon\AWSCLIV2\目录中。可以通过查询注册表来动态获取此路径，确保脚本的适应性更强。
```
$AWSCLIPath = Get-ItemProperty "HKLM:\SOFTWARE\Amazon\AWSCLI" | Select-Object -ExpandProperty InstallPath
```
在所有aws命令中使用完整路径。 使用变量${AWSCLIPath}\aws.exe替代脚本中的aws命令。
```
function Download-SolarWindsInstaller {
    # 使用完整路径执行 aws s3 cp 命令
    $result1 = & "${AWSCLIPath}\aws.exe" s3 cp $S3BucketURL1 $SolarWindsOutput1 --quiet
}
```
使用完整的可执行文件路径，使用 & 符号执行，从而保证即使环境变量没有正确设置，命令也能正确执行。

解决方案3：重启PowerShell会话

如果刷新环境变量后问题仍然存在，尝试重启PowerShell会话可能解决该问题。新的会话将自动加载所有最新的环境变量，确保aws命令可识别。

添加重启会话的提示信息 如果之前的解决方案无效，向用户提供重启会话的指导。

 else {
      Write-Warning "AWS CLI might require a new PowerShell session to be fully recognized. Please restart your PowerShell session and try again."
      # You might also try automatically restarting the session (requires caution):
      # Stop-Process -Id $PID
}

配置 AWS CLI：

除了确保 AWS CLI 可用之外，脚本还需要配置 AWS CLI，包括访问密钥、Secret 密钥和区域信息。在脚本中使用环境变量进行配置是相对安全的方式。

# 使用环境变量配置AWS CLI
function Configure-AWSCLI {
    Write-Host "Configuring AWS CLI with environment variables..."
    try {
        aws configure set aws_access_key_id $env:AWS_ACCESS_KEY_ID
        aws configure set aws_secret_access_key $env:AWS_SECRET_ACCESS_KEY
        aws configure set region $env:AWS_DEFAULT_REGION

        Write-Host "AWS CLI configured successfully."
    } catch {
        Write-Error "Failed to configure AWS CLI. Error: $_"
        throw
    }
}