.NET Core 5 Windows Service如何传递命令行参数？

阿华AIGC实验室

2026-4-30

给.NET Core 5 Windows服务传递命令行参数的解决方案

我完全懂你遇到的困扰——在Visual Studio里调试服务时能正常拿到命令行参数，但用sc.exe创建服务后就获取不到，服务控制面板也没法直接传参。这是因为Windows服务的参数传递逻辑和普通控制台程序不一样，下面给你几种可行的解决办法：

方法1：创建/配置服务时在`binPath`中直接包含参数

用sc.exe操作服务时，必须把命令行参数直接追加到可执行文件路径后面，并且用引号把「路径+参数」的整体包起来。注意binPath=后面的等号和引号之间要留一个空格，这是sc.exe的语法要求。

比如创建新服务时：

sc create MyService binPath= "C:\YourService\MyService.exe --environment staging --log-level debug"

如果已经创建了服务，想修改参数可以用config命令：

sc config MyService binPath= "C:\YourService\MyService.exe --environment production"

这样服务启动时，这些参数会直接传递到你Main方法的args数组里，和Visual Studio调试时的逻辑完全一致。

方法2：通过注册表修改启动参数

Windows服务的配置信息存在注册表中，你可以手动修改ImagePath项来添加参数：

打开注册表编辑器，定位到HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\MyService
找到名为ImagePath的字符串值，双击编辑
在原有可执行文件路径的后面追加命令行参数，比如：
```
"C:\YourService\MyService.exe" --custom-param "value with spaces"
```
保存后重启服务，参数就会生效。

方法3：在代码里正确读取参数

你已经在Main方法里拿到了args，可以直接处理，或者借助.NET Core的配置系统解析：
比如在ConfigureServices里，通过IConfiguration访问命令行参数：

public static IHostBuilder CreateHostBuilder(string[] args)
{
    return Host.CreateDefaultBuilder(args)
        .UseWindowsService(options => { options.ServiceName = "MyService"; })
        .ConfigureServices((context, services) =>
        {
            // 直接读取单个参数
            var env = context.Configuration["environment"];
            // 或者绑定到自定义配置类
            var serviceSettings = new ServiceSettings();
            context.Configuration.Bind(serviceSettings);
            
            services.AddHostedService<Worker>();
        });
}

Host.CreateDefaultBuilder(args)已经自动把命令行参数加入配置系统，你可以像读取配置文件一样读取它们。