New-Service

새 Windows 서비스를 만듭니다.

Syntax

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

Description

이 cmdlet은 Windows 플랫폼에서만 사용할 수 있습니다.

이 cmdlet은 New-Service 레지스트리 및 서비스 데이터베이스에서 Windows 서비스에 대한 새 항목을 만듭니다. 새 서비스에는 서비스 중에 실행되는 실행 파일이 필요합니다.

이 cmdlet의 매개 변수를 사용하면 서비스의 표시 이름, 설명, 시작 유형 및 종속성을 설정할 수 있습니다.

예제

예제 1: 서비스 만들기

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

이 명령은 TestService라는 서비스를 만듭니다.

예제 2: 설명, 시작 유형 및 표시 이름을 포함하는 서비스 만들기

$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 를 사용하여 새 서비스에 대한 설명, 시작 유형 및 표시 이름을 지정합니다.

예제 3: 새 서비스 보기

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

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

이 명령은 새 서비스에 대한 Win32_Service 개체를 가져오는 데 사용합니다Get-CimInstance. 이 개체에는 시작 모드와 서비스 설명이 포함되어 있습니다.

예제 4: 만들 때 서비스의 SecurityDescriptor를 설정합니다.

다음은 생성 중인 서비스의 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 매개 변수는 새 서비스의 SecurityDescriptor를 설정하는 데 사용합니다$SDDL.

매개 변수

-BinaryPathName

서비스에 대한 실행 파일의 경로를 지정합니다. 이 매개 변수는 필수입니다.

서비스 이진 파일에 대한 정규화된 경로입니다. 경로에 공백이 포함되어 있으면 올바르게 해석되도록 따옴표로 묶어야 합니다. 예를 들어 . d:\my share\myservice.exe'"d:\my share\myservice.exe"'지정해야 합니다.

경로에는 자동 시작 서비스에 대한 인수도 포함될 수 있습니다. 예: '"d:\myshare\myservice.exe arg1 arg2"'. 이러한 인수는 서비스 진입점으로 전달됩니다.

자세한 내용은 CreateServiceW API의 lpBinaryPathName 매개 변수를 참조하세요.

Type:String
Aliases:Path
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Confirm

cmdlet을 실행하기 전에 확인을 요청합니다.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-Credential

서비스에서 서비스 로그온 계정으로 사용하는 계정을 지정합니다.

User01 또는 Domain01\User01과 같은 사용자 이름을 입력하거나 cmdlet에서 생성된 것과 같은 PSCredential 개체를 Get-Credential 입력합니다. 사용자 이름을 입력하는 경우 이 cmdlet은 암호를 묻는 메시지를 표시합니다.

자격 증명은 PSCredential 개체에 저장되고 암호는 SecureString으로 저장됩니다.

참고

SecureString 데이터 보호에 대한 자세한 내용은 SecureString의 보안 방법을 참조하세요.

Type:PSCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DependsOn

새 서비스가 종속되는 다른 서비스의 이름을 지정합니다. 여러 서비스 이름을 입력하려면 쉼표를 사용하여 이름을 구분합니다.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Description

서비스에 대한 설명을 지정합니다.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisplayName

서비스의 표시 이름을 지정합니다.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Name

서비스의 이름을 지정합니다. 이 매개 변수는 필수입니다.

Type:String
Aliases:ServiceName
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SecurityDescriptorSddl

서비스의 SecurityDescriptorSddl 형식으로 지정합니다.

Type:String
Aliases:sd
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-StartupType

서비스의 시작 유형을 설정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • 자동 - 서비스가 시작되거나 운영 체제에서 시스템 시작 시 시작되었습니다. 자동으로 시작된 서비스가 수동으로 시작된 서비스에 따라 달라지는 경우, 시스템 시작 시 수동으로 시작된 서비스도 자동으로 시작됩니다.
  • AutomaticDelayedStart - 시스템이 부팅된 직후에 시작됩니다.
  • 사용 안 함 - 서비스를 사용할 수 없으며 사용자 또는 애플리케이션에서 시작할 수 없습니다.
  • InvalidValue - 이 값은 지원되지 않습니다. 이 값을 사용하면 오류가 발생합니다.
  • 수동 - 서비스는 사용자, 서비스 제어 관리자 사용 또는 애플리케이션에서만 수동으로 시작됩니다.

기본값은 Automatic입니다.

Type:Microsoft.PowerShell.Commands.ServiceStartupType
Accepted values:Automatic, Manual, Disabled, AutomaticDelayedStart, InvalidValue
Position:Named
Default value:Automatic
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

cmdlet을 실행할 경우 발생하는 일을 표시합니다. cmdlet은 실행되지 않습니다.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

입력

None

이 cmdlet에 입력을 파이프할 수 없습니다.

출력

ServiceController

이 cmdlet은 새 서비스를 나타내는 개체를 반환합니다.

참고

이 cmdlet은 Windows 플랫폼에서만 사용할 수 있습니다.

이 cmdlet을 실행하려면 관리자 권한으로 실행 옵션을 사용하여 PowerShell을 시작합니다.