New-Service
새 Windows 서비스를 만듭니다.
구문
New-Service [-Name] <string> [-BinaryPathName] <string> [-Credential <PSCredential>] [-DependsOn <string[]>] [-Description <string>] [-DisplayName <string>] [-StartupType {<Automatic> | <Manual> | <Disabled>}] [-Confirm] [-WhatIf] [<CommonParameters>]
설명
New-Service cmdlet은 레지스트리와 서비스 데이터베이스에 새 Windows 서비스 항목을 만듭니다. 새 서비스를 사용하려면 서비스 사용 중 실행되는 실행 파일이 있어야 합니다.
이 cmdlet의 매개 변수를 사용하면 서비스의 표시 이름, 설명, 시작 유형 및 종속성을 설정할 수 있습니다.
매개 변수
-BinaryPathName <string>
서비스의 실행 파일 경로를 지정합니다. 이 매개 변수는 필수 사항입니다.
필수 여부 |
true |
위치 |
2 |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-Credential <PSCredential>
이 작업을 수행할 수 있는 권한을 가진 사용자 계정을 지정합니다. "User01" 또는 "Domain01\User01"과 같은 사용자 이름을 입력합니다. 또는 Get-Credential cmdlet에서 반환된 개체와 같은 PSCredential 개체를 입력합니다. 사용자 이름을 입력하면 암호를 묻는 메시지가 표시됩니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-DependsOn <string[]>
새 서비스가 종속되는 다른 서비스의 이름을 지정합니다. 여러 서비스 이름을 입력하려면 쉼표를 사용하여 이름을 구분합니다.
필수 여부 |
false |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-Description <string>
서비스에 대한 설명을 지정합니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-DisplayName <string>
서비스의 표시 이름을 지정합니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-Name <string>
서비스의 이름을 지정합니다. 이 매개 변수는 필수 사항입니다.
필수 여부 |
true |
위치 |
1 |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-StartupType <ServiceStartMode>
서비스의 시작 유형을 설정합니다. 기본값은 "Automatic"입니다.
유효한 값은 다음과 같습니다.
-- Manual: 서비스는 항상 응용 프로그램이나 서비스 제어 관리자를 사용하는 사용자에 의해 수동으로 시작됩니다.
-- Automatic: 서비스가 시스템 시작 시 운영 체제에 의해 시작됩니다. 자동으로 시작되는 서비스가 수동으로 시작되는 서비스에 종속된 경우 수동으로 시작되는 서비스도 시스템 시작 시 자동으로 시작됩니다.
-- Disabled: 서비스를 사용하지 않도록 설정하며 사용자나 응용 프로그램에서 시작할 수 없습니다.
필수 여부 |
false |
위치 |
named |
기본값 |
Automatic |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-Confirm
명령을 실행하기 전에 확인 메시지를 표시합니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-WhatIf
명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
<CommonParameters>
이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_commonparameters.
입력 및 출력
입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.
입력 |
없음 입력을 이 cmdlet으로 파이프할 수 없습니다. |
출력 |
System.ServiceProcess.ServiceController New-Service 명령은 새 서비스를 나타내는 개체를 반환합니다. |
참고
Windows Vista 이상에서 이 cmdlet을 실행하려면 "관리자 권한으로 실행" 옵션을 사용하여 Windows PowerShell을 시작합니다.
예 1
C:\PS>new-service -name TestService -binaryPathName "C:\WINDOWS\System32\svchost.exe -k netsvcs"
설명
-----------
이 명령은 "TestService"라는 새 서비스를 만듭니다.
예 2
C:\PS>new-service -name TestService -path "C:\WINDOWS\System32\svchost.exe -k netsvcs" -dependson NetLogon -displayName "Test Service" -StartupType Manual -Description "This is a test service."
설명
-----------
이 명령은 "TestService"라는 새 서비스를 만들고, New-Service cmdlet의 매개 변수를 사용하여 새 서비스의 설명, 시작 유형 및 표시 이름을 지정합니다.
BinaryPathName 매개 변수는 Path 매개 변수 별칭을 사용하여 지정합니다. "-bpn"을 사용할 수도 있습니다.
예 3
C:\PS>get-wmiobject win32_service -filter "name='testservice'"
ExitCode : 0
Name : testservice
ProcessId : 0
StartMode : Auto
State : Stopped
Status : OK
설명
-----------
이 명령은 Get-WmiObject cmdlet을 사용하여 새 서비스를 나타내는 Win32_Service 개체를 가져옵니다. 이 개체에는 시작 모드와 서비스 설명이 포함되어 있습니다.
참고 항목
개념
Get-Service
Start-Service
Stop-Service
Restart-Service
Resume-Service
Set-Service
Suspend-Service