DOCKERFILE中运行PowerShell Write-EventLog时参数解析失败问题

问题场景 #

在Windows Server环境的Dockerfile中，创建自定义事件日志的命令执行正常，但执行Write-EventLog写入带空格的消息时抛出参数绑定异常：

执行的Dockerfile命令 #

RUN powershell.exe -command Write-EventLog -LogName "my_log_name" -Source "my_source" -Message "EventLog created by DOCKERFILE." -Category 0 -EventID 0 -EntryType Information

抛出的异常 #

Write-EventLog : A positional parameter cannot be found that accepts argument 
'created'.
At line:1 char:1
+ Write-EventLog -LogName my_log_name -Source my_source -EntryType Messag ...
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : InvalidArgument: (:) [Write-EventLog], Parameter 
   BindingException
    + FullyQualifiedErrorId : PositionalParameterNotFound,Microsoft.PowerShell 
   .Commands.WriteEventLogCommand

尝试过给消息加括号、套双引号、用单引号包裹参数、移除引号转义空格等操作，均无法解决问题。

问题原因 #

核心问题出在Docker的RUN命令与PowerShell的参数解析逻辑冲突：
当你在RUN里直接写带双引号的参数时，Docker会先解析外层的命令行，把"EventLog created by DOCKERFILE."拆分成EventLog、created、by、DOCKERFILE.四个独立的参数传递给PowerShell。这导致PowerShell收到的命令中，created变成了没有对应参数名的 positional 参数，从而触发PositionalParameterNotFound异常。

解决方法 #

方法1：用单引号包裹整个PowerShell命令，转义内部单引号 #

把整个PowerShell命令用单引号包裹，同时将消息字符串的双引号替换为两个连续的单引号（PowerShell中用于转义单引号）：

RUN powershell.exe -command 'Write-EventLog -LogName "my_log_name" -Source "my_source" -Message ''EventLog created by DOCKERFILE.'' -Category 0 -EventID 0 -EntryType Information'

方法2：使用Base64编码命令（最可靠） #

PowerShell支持通过-EncodedCommand参数执行Base64编码的命令，完全避免解析冲突：

1. 在本地PowerShell中执行以下命令，获取目标命令的Base64编码：

$cmd = 'Write-EventLog -LogName "my_log_name" -Source "my_source" -Message "EventLog created by DOCKERFILE." -Category 0 -EventID 0 -EntryType Information'
[Convert]::ToBase64String([System.Text.Encoding]::Unicode.GetBytes($cmd))

2. 将得到的编码字符串复制到Dockerfile中：

RUN powershell.exe -EncodedCommand VwByAGkAdABlAC0ARQB2AGUAdABsAE8AZwAgAC0ATABvAGcATgBhAG0AZQAgACIAbQB5AF8AbABvAGcAXwBuAGEAbQBlACIAIAAtAFMAbwB1AHIAYwBlACAAIgBtAHkAcwBvAHUAcgBjAGUAIgAgAC0ATQBlAHMAcwBhAGcAZQAgACIAZQB2AGUAdABsAG8AZwAgAGMAcgBlAGEAdABlAGQAIABieSBET0NLRSBGSUxFAC4iACAALQBDAGEAdABlAGcAcgB5ACAAMAAgAC0ARQBlAG4AdAB5AEkARAAgADAALAAgAC0ARQBuAHQAeQB0AHkAIABJAG4AZgByAG8AbQBhAHQAaQBvAG4A

为什么之前的尝试无效 #

• 给消息加括号：仅将字符串转为PowerShell表达式，但无法阻止Docker提前拆分参数；
• 直接套双引号：Docker解析后会去掉外层双引号，PowerShell仍会收到拆分后的参数；
• 移除引号转义空格：没有引号包裹的空格会直接被Docker当作参数分隔符，问题更严重。

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