Docker传递参数语法问题：回显ARG及传入PowerShell命令方法

我来帮你梳理一下Docker ARG参数的回显语法，以及将其传入PowerShell命令的正确姿势，结合你的尝试来修正问题：

在Windows容器环境中，回显ARG参数需要注意当前执行环境是cmd还是PowerShell：

• 如果是cmd环境（部分基础镜像默认使用cmd）：用%变量名%包裹变量，示例：

  RUN echo "连接字符串：%web_connection_string%"
  

• 如果是PowerShell环境：ARG会自动成为构建阶段的环境变量，通过$env:变量名获取并输出，示例：

  RUN powershell -NoProfile -Command "Write-Host '当前ARG值：$env:web_connection_string'"
  

你的尝试里踩了一个常见坑：Dockerfile中直接写$web_connection_string会被Docker引擎优先解析，而不是传递给PowerShell。这里有两种可靠的解决方式：

方式一：利用PowerShell环境变量（推荐） #

ARG参数在构建阶段会自动注入为环境变量，调用脚本时直接引用PowerShell的环境变量即可：

修正后的Dockerfile片段 #

FROM microsoft/aspnet
ARG web_connection_string

# 先验证ARG值（PowerShell方式）
RUN powershell -NoProfile -Command "Write-Host '当前ARG值：$env:web_connection_string'"

ADD ./setup.ps1 /setup.ps1
# 传递ARG给PowerShell脚本
RUN powershell -NoProfile -File C:\setup.ps1 -websiteDir "C:/inetpub/wwwroot" -webConnectionString "$env:web_connection_string"

配套的setup.ps1参数定义 #

param(
    [Parameter(Mandatory=$true)]
    [string]$websiteDir,
    [Parameter(Mandatory=$true)]
    [string]$webConnectionString
)

# 验证参数是否正确传递
Write-Host "接收的网站目录：$websiteDir"
Write-Host "接收的连接字符串：$webConnectionString"

方式二：转义$符号避免Docker解析 #

如果不想依赖环境变量，需要把Dockerfile中的$转义为$$，这样Docker会把$$解析为单个$传递给PowerShell：

RUN powershell -NoProfile -File C:\setup.ps1 -websiteDir "C:/inetpub/wwwroot" -webConnectionString "$$web_connection_string"

原写法的问题所在 #

原Dockerfile中-webConnectionString $web_connection_string里的$web_connection_string会被Docker当成自身的变量语法尝试解析，而不是直接传递给PowerShell，导致参数无法正确传入脚本。

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