SSM用户无法访问系统环境变量 咨询无需重启的刷新方法

原因 #

1. Windows环境变量加载机制：Machine级别的系统环境变量存储在注册表中，所有进程在启动时会一次性读取这些变量，已运行的进程不会自动感知后续的变量修改。
2. SSM Agent的运行特性：AWS SSM Agent是以Windows服务的形式运行的，它启动时加载了当时的系统环境变量。后续通过[Environment]::SetEnvironmentVariable添加的Machine变量，不会自动同步到SSM Agent的进程环境中，而SSM会话是由Agent派生的子进程，会直接继承Agent的环境变量，因此无法访问新设置的变量。
3. refreshenv的局限性：Chocolatey的refreshenv仅能刷新当前PowerShell会话的环境变量，无法影响已经运行的系统服务进程（比如SSM Agent），因为服务的环境空间和用户会话是完全隔离的。

最优解决方案 #

直接重启AWS SSM Agent服务，让它重新从注册表读取最新的Machine级环境变量，后续创建的SSM会话就能自动获取到新变量，无需重启整个实例：

Restart-Service AmazonSSMAgent

其他可选方案（仅适用于无法重启Agent的场景） #

• 手动在SSM会话中加载变量：每次打开SSM会话后，执行以下命令手动读取注册表中的变量并设置到当前会话环境：

  $machineEnv = Get-ItemProperty 'HKLM:\SYSTEM\CurrentControlSet\Control\Session Manager\Environment'
  $env:MYVARYABLE = $machineEnv.MYVARYABLE
  

  注意：此方法仅对当前SSM会话有效，新会话需要重复执行。
• 设置变量时同步更新当前进程：在设置Machine变量的同时，同步更新当前进程的环境变量，但这仅对当前执行命令的进程有效，无法让SSM Agent感知，因此仅作为临时补充：

  [Environment]::SetEnvironmentVariable("MYVARYABLE", "variable_value", [System.EnvironmentVariableTarget]::Machine)
  [Environment]::SetEnvironmentVariable("MYVARYABLE", "variable_value", [System.EnvironmentVariableTarget]::Process)
  

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