关于本文
本文是通过利用生成式 AI 的自动化生成流程创建的。在参考了 Microsoft Learn 的 WPF/XAML 资料以及现有的 Daily-Code-Samples 之后，在打磨外观之前，将其整理为一个能够将 Click 事件传递给 PowerShell 的极简 GUI。
验证状态：📘 已核实官方信息・Windows 实机未验证
使用 PowerShell 同样可以借助 WPF/XAML 创建 GUI。不过，与其一开始就制作业务应用，不如通过 1 个 TextBox 和 1 个 Button 来确认“按下 XAML 按钮 -> 运行 PowerShell 事件处理程序”，这样更容易理解其运作机制。
本次的成功条件
如果发生以下 4 种情况，则说明冒烟测试（Smoke Test）成功。
窗口打开
能够在 TextBox 中输入文字
能够点击 Button
界面和控制台输出
[SUCCESS]/[RESULT]
WPF 与 XAML 的角色可以在 Microsoft Learn 中进行确认。
首先让它运行起来
以 STA 模式启动 Windows PowerShell 5.1 并进行尝试。
Add-Type -AssemblyName PresentationFramework
[xml]$xaml = @'
<Window xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
Title="papanda Smoke Test" Width="380" Height="180">
<StackPanel Margin="20">
<TextBox Name="InputText" Margin="0,0,0,10" />
<Button Name="RunButton" Content="イベントを送る" />
<TextBlock Name="ResultText" Margin="0,12,0,0" />
</StackPanel>
</Window>
'@
$reader = [System.Xml.XmlNodeReader]::new($xaml)
$window = [Windows.Markup.XamlReader]::Load($reader)
$input = $window.FindName('InputText')
$button = $window.FindName('RunButton')
$result = $window.FindName('ResultText')
$button.Add_Click({
$result.Text = "[SUCCESS] PowerShellで受信: $($input.Text)"
Write-Host "[RESULT] Text = $($input.Text)"
})
[void]$window.ShowDialog()
在运行时，像下面这样显式指定 STA 会更清晰易懂。
powershell.exe -STA
看这里
负责构建界面的是 XAML，编写 Click 之后处理逻辑的是 PowerShell。FindName() 将 XAML 中的命名元素桥接到 PowerShell 侧，而 Add_Click() 则将处理逻辑注册到 Button 的 Click 事件中。
sequenceDiagram
participant U as User
participant X as XAML Button
participant W as WPF event loop
participant P as PowerShell handler
U->>X: Click
X->>W: Click event
W->>P: Add_Click handler
P-->>X: ResultTextを更新
不能仅凭显示出 GUI 就判定为成功。只有当点击按钮的结果成功传递到 PowerShell 侧时，才能认为事件布线已经确认无误。
尝试修改一个地方
Button 仅将中的 Content="イベントを送る" 修改为其他字符并重新运行。处理逻辑保持不变，从而可以确认 XAML 负责的是界面结构与显示。
接下来，如果逐步添加 1 个 TextBlock、改为 Grid、添加颜色，就能更容易地排查出是哪次修改引发了问题。
为什么会出现 STA
WPF 中存在 UI 线程和 Dispatcher 的概念。当从 PowerShell 操作 WPF 时，这与线程的 ApartmentState（单元状态）有关。在完整版示例中，如果不是 STA 则会被显式视为失败。
如果在工作中应用
在进行 GUI 化之前，最好确保核心处理逻辑能够作为独立函数单独运行，这样更加安全。
将 GUI 外观与处理逻辑分离
不对空输入照单全收
不要在 UI 线程中直接循环执行长时间运行的操作
不要吞掉异常却显示成功
考虑按钮连击或重复执行的情况
先让最初的冒烟测试运行成功，然后再添加修饰，这样即使是初学者也更容易追溯原因。
GitHub 示例
完整版包含了 STA 确认、空输入以及 [FAILED] 显示。
官方信息与一手资料
总结
PowerShell + XAML 的最初目标不是华丽的界面，而是用肉眼确认 UI 事件能够传达到 PowerShell。当极简 GUI 运行成功后，就可以安全地逐个叠加功能和外观了。
