New-Service

New-Service
    [-Name] <String>
    [-BinaryPathName] <String>
    [-DisplayName <String>]
    [-Description <String>]
    [-SecurityDescriptorSddl <String>]
    [-StartupType <ServiceStartupType>]
    [-Credential <PSCredential>]
    [-DependsOn <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

此 cmdlet 仅在 Windows 平台上可用。

New-Service cmdlet 为注册表和服务数据库中的 Windows 服务创建新条目。 新服务需要一个在服务期间运行的可执行文件。

使用此 cmdlet 的参数可以设置服务的显示名称、说明、启动类型和依赖项。

New-Service -Name "TestService" -BinaryPathName '"C:\WINDOWS\System32\svchost.exe -k netsvcs"'

此命令创建名为 TestService 的服务。

$params = @{
  Name = "TestService"
  BinaryPathName = '"C:\WINDOWS\System32\svchost.exe -k netsvcs"'
  DependsOn = "NetLogon"
  DisplayName = "Test Service"
  StartupType = "Manual"
  Description = "This is a test service."
}
New-Service @params

此命令创建名为 TestService 的服务。 它使用 New-Service 的参数来指定新服务的说明、启动类型和显示名称。

Get-CimInstance -ClassName Win32_Service -Filter "Name='testservice'"

ExitCode  : 0
Name      : testservice
ProcessId : 0
StartMode : Auto
State     : Stopped
Status    : OK

此命令使用 Get-CimInstance 获取新服务的 Win32_Service 对象。 此对象包括启动模式和服务说明。

此示例添加所创建的服务的 SecurityDescriptor。

$SDDL = "D:(A;;CCLCSWRPWPDTLOCRRC;;;SY)(A;;CCDCLCSWRPWPDTLOCRSDRCWDWO;;;BA)(A;;CCLCSWLOCRRC;;;SU)"
$params = @{
  BinaryPathName = '"C:\WINDOWS\System32\svchost.exe -k netsvcs"'
  DependsOn = "NetLogon"
  DisplayName = "Test Service"
  StartupType = "Manual"
  Description = "This is a test service."
  SecurityDescriptorSddl = $SDDL
}
New-Service @params

SecurityDescriptor 存储在 $SDDLToSet 变量中。 SecurityDescriptorSddl 参数使用 $SDDL 来设置新服务的 SecurityDescriptor。

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

不能通过管道将输入传递给此 cmdlet。

此 cmdlet 返回一个表示新服务的对象。

此 cmdlet 仅在 Windows 平台上可用。

若要运行此 cmdlet，请使用 以管理员身份运行 选项启动 PowerShell。