New-Service

구문

Default (기본값)

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

Description

예제

Example 1: Create a service

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

Example 2: Create a service that includes description, startup type, and display name

$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

Example 3: View the new service

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

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

Example 4: Set the SecurityDescriptor of a service when creating.

$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

매개 변수

-BinaryPathName

Specifies the path of the executable file for the service. This parameter is required.

The fully qualified path to the service binary file. If the path contains a space, it must be quoted so that it is correctly interpreted. For example, D:\my share\myservice.exe should be specified as '"D:\my share\myservice.exe"'.

The path can also include arguments for an auto-start service. For example, '"D:\my share\myservice.exe" arg1 arg2'. These arguments are passed to the service entry point.

For more information, see the lpBinaryPathName parameter of CreateServiceW API.

매개 변수 속성

매개 변수 집합

-Confirm

Prompts you for confirmation before running the cmdlet.

매개 변수 속성

매개 변수 집합

-Credential

Specifies the account used by the service as the Service Logon Account.

Type a user name, such as User01 or Domain01\User01, or enter a PSCredential object, such as one generated by the Get-Credential cmdlet. If you type a user name, this cmdlet prompts you for a password.

Credentials are stored in a PSCredential object and the password is stored as a SecureString.

매개 변수 속성

매개 변수 집합

-DependsOn

Specifies the names of other services upon which the new service depends. To enter multiple service names, use a comma to separate the names.

매개 변수 속성

매개 변수 집합

-Description

Specifies a description of the service.

매개 변수 속성

매개 변수 집합

-DisplayName

Specifies a display name for the service.

매개 변수 속성

매개 변수 집합

-Name

Specifies the name of the service. This parameter is required.

매개 변수 속성

매개 변수 집합

-SecurityDescriptorSddl

Specifies the SecurityDescriptor for the service in Sddl format.

매개 변수 속성

매개 변수 집합

-StartupType

Sets the startup type of the service. The acceptable values for this parameter are:

• Automatic - The service is started or was started by the operating system, at system start-up. If an automatically started service depends on a manually started service, the manually started service is also started automatically at system startup.
• AutomaticDelayedStart - Starts shortly after the system boots.
• Disabled - The service is disabled and cannot be started by a user or application.
• InvalidValue - This value is not supported. Using this value results in an error.
• Manual - The service is started only manually, by a user, using the Service Control Manager, or by an application.

The default value is Automatic.

매개 변수 속성

매개 변수 집합

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

매개 변수 속성

매개 변수 집합

CommonParameters

입력

None

출력

ServiceController

참고

관련 링크

• Get-Service
• Restart-Service
• Resume-Service
• Set-Service
• Start-Service
• Stop-Service
• Suspend-Service
• Remove-Service