New-Service 帮助信息

如下说明是翻译PowerShell中 : help New-Service 产生的帮助信息 .

译者 : Edengundam( 马涛 )

 

New-Service

 

大纲

在注册表和服务数据库 (Service Database) 中为 Windows 服务创建新项 .

 

语法

New-Service [-name] <string> [-binaryPathName] <string> [-displayName <string>] [-description <string>] [-startupType {<Automatic> | <Manual> | <Disabled>}] [-credential <PSCredential>] [-dependsOn <string[]>] [-whatIf] [-confirm] [<CommonParameters>]

 

详细描述

在注册表和服务数据库 (Service Database) 中为 Windows 服务创建新项 . 此 cmdlet 允许你设置服务的显示名称 , 名称 , 启动类型和依赖关系 .

 

参数

 

-name <string>

指定服务的名称 .

 

强制参数 ?	true
参数位置 ?	1
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-binaryPathName <string>

指定服务的可执行文件路径 .

 

强制参数 ?	true
参数位置 ?	2
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-displayName <string>

为服务指定新的显示名 .

 

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-description <string>

为服务指定新的描述 .

 

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-startupType <ServiceStartMode>

设置服务的启动类型 .

 

此参数接受的输入值 :

 

·          Automatic

·          Manual

·          Disabled

 

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-credential <PSCredential>

指定服务启动使用的凭证 .

 

强制参数 ?	false
参数位置 ?	named
默认值	LocalSystem
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-dependsOn <string[]>

新服务依赖的服务名称 . 使用逗号分隔多个服务名称

 

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-whatIf

描述执行此命令将会发生的现象 , 不会真正执行此命令 .

 

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

-confirm

执行命令前提示你进行确认 .

 

强制参数 ?	false
参数位置 ?	named
默认值
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

< 公共参数 >

此命令支持公共参数 : -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. 更多信息 , 输入 , "get-help about_commonparameters".

 

输入类型

None

 

RETURN TYPE

ServiceControllerObject

 

注意

 

更多信息 , 输入 "Get-Help New-Service  -detailed". 需要技术信息 , 输入 "Get-Help New-Service -full".

 

如果需要为该命令提供多个参数 , 请使用逗号进行分隔 . 例如 , "<parameter-name> <value1>, <value2>".

 

例 1

 

C:/PS>new-service testservice "C:/WINDOWS/System32/svchost.exe -k netsvcs"

 

此命令将在注册表和服务数据库中为名为 "testservice" 的服务创建新项 .

 

相关链接

Get-Service

Start-Service

Stop-Service

Restart-Service

Resume-Service

Set-Service

Suspend-Service