다음을 통해 공유


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