New-Service
새 Windows 서비스를 만듭니다.
구문
New-Service
[-Name] <String>
[-BinaryPathName] <String>
[-DisplayName <String>]
[-Description <String>]
[-StartupType <ServiceStartMode>]
[-Credential <PSCredential>]
[-DependsOn <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
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: 서비스 삭제
sc.exe delete TestService
# - or -
(Get-CimInstance -Class Win32_Service -Filter "name='TestService'").delete()이 예제에서는 TestService 서비스를 삭제하는 두 가지 방법을 보여줍니다. 첫 번째 명령은 .의 Sc.exe삭제 옵션을 사용합니다. 두 번째 명령은 반환되는 Win32_Service 개체의 Delete 메서드를 Get-CimInstance 사용합니다.
매개 변수
-BinaryPathName
서비스에 대한 실행 파일의 경로를 지정합니다. 이 매개 변수는 필수입니다.
서비스 이진 파일에 대한 정규화된 경로입니다. 경로에 공백이 포함된 경우 올바르게 해석되도록 따옴표로 묶어야 합니다. 예를 들어 . d:\my share\myservice.exe 로 '"d:\my share\myservice.exe"'지정해야 합니다.
경로에는 자동 시작 서비스에 대한 인수도 포함될 수 있습니다. 예들 들어 '"d:\my share\myservice.exe" arg1 arg2'입니다. 이러한 인수는 서비스 진입점으로 전달됩니다.
자세한 내용은 CreateServiceW API의 lpBinaryPathName 매개 변수를 참조하세요.
| 형식: | String |
| Position: | 1 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.
| 형식: | SwitchParameter |
| 별칭: | cf |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Credential
서비스에서 서비스 로그온 계정으로 사용하는 계정을 지정합니다.
User01 또는 Domain01\User01과 같은 사용자 이름을 입력하거나 cmdlet에서 생성된 것과 같은 PSCredential 개체를 Get-Credential 입력합니다. 사용자 이름을 입력하는 경우 이 cmdlet은 암호를 묻는 메시지를 표시합니다.
자격 증명은 PSCredential 개체에 저장되고 암호는 SecureString으로 저장됩니다.
참고 항목
SecureString 데이터 보호에 대한 자세한 내용은 SecureString이 얼마나 안전한가요?를 참조하세요.
| 형식: | PSCredential |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DependsOn
새 서비스가 종속되는 다른 서비스의 이름을 지정합니다. 여러 서비스 이름을 입력하려면 쉼표로 이름을 구분합니다.
| 형식: | String[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Description
서비스에 대한 설명을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DisplayName
서비스의 표시 이름을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Name
서비스의 이름을 지정합니다. 이 매개 변수는 필수입니다.
| 형식: | String |
| 별칭: | ServiceName |
| Position: | 0 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-StartupType
서비스의 시작 유형을 설정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.
- 자동 - 서비스가 시스템 시작 시 운영 체제에서 시작되거나 시작되었습니다. 자동으로 시작되는 서비스가 수동으로 시작되는 서비스에 종속된 경우 수동으로 시작되는 서비스도 시스템 시작 시 자동으로 시작됩니다.
- 사용 안 함 - 서비스를 사용할 수 없으며 사용자 또는 애플리케이션에서 시작할 수 없습니다.
- 수동 - 서비스는 수동, 사용자, 서비스 제어 관리자 사용 또는 애플리케이션에서만 시작됩니다.
- 부팅 - 서비스가 시스템 로더에서 시작한 디바이스 드라이버임을 나타냅니다. 이 값은 디바이스 드라이버에만 유효합니다.
- 시스템 - 서비스가 'IOInitSystem()' 함수에서 시작한 디바이스 드라이버임을 나타냅니다. 이 값은 디바이스 드라이버에만 유효합니다.
기본값은 Automatic입니다.
| 형식: | ServiceStartMode |
| 허용되는 값: | Boot, System, Automatic, Manual, Disabled |
| Position: | Named |
| Default value: | Automatic |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-WhatIf
cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.
| 형식: | SwitchParameter |
| 별칭: | wi |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
입력
None
개체를 이 cmdlet으로 파이프할 수 없습니다.
출력
이 cmdlet은 새 서비스를 나타내는 개체를 반환합니다.
참고
이 cmdlet을 실행하려면 관리자 권한으로 실행 옵션을 사용하여 PowerShell을 시작합니다.
서비스를 삭제하려면 Sc.exe 사용하거나 cmdlet을 사용하여 Get-CimInstance 서비스를 나타내는 Win32_Service 개체를 가져와서 Delete 메서드를 사용하여 서비스를 삭제합니다. 반환하는 개체에 Get-Service delete 메서드가 없습니다.
관련 링크
PowerShell