Stop-Service
실행 중인 하나 이상의 서비스를 중지합니다.
구문
Stop-Service [-Name] <string[]> [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
Stop-Service -DisplayName <string[]> [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
Stop-Service [-InputObject <ServiceController[]>] [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]
설명
Stop-Service cmdlet은 지정된 각 서비스에 대한 중지 메시지를 Windows 서비스 컨트롤러로 보냅니다. 서비스 이름 또는 표시 이름으로 서비스를 지정하거나 InputObject 매개 변수를 사용하여 중지할 서비스를 나타내는 서비스 개체를 전달할 수 있습니다.
매개 변수
-DisplayName <string[]>
중지할 서비스의 표시 이름을 지정합니다. 와일드카드를 사용할 수 있습니다.
필수 여부 |
true |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-Exclude <string[]>
지정된 서비스를 생략합니다. 이 매개 변수의 값은 Name 매개 변수를 한정합니다. 이름 요소 또는 패턴(예: "*s*")을 입력하십시오. 와일드카드를 사용할 수 있습니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-Force
cmdlet이 종속 서비스가 있는 서비스도 중지할 수 있도록 허용합니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-Include <string[]>
지정된 서비스만 중지합니다. 이 매개 변수의 값은 Name 매개 변수를 한정합니다. 이름 요소 또는 패턴(예: "*s*")을 입력하십시오. 와일드카드를 사용할 수 있습니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-InputObject <ServiceController[]>
중지할 서비스를 나타내는 ServiceController 개체를 지정합니다. 개체가 포함된 변수를 입력하거나 개체를 가져오는 명령 또는 식을 입력하십시오.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
true (ByValue) |
와일드카드 문자 적용 여부 |
false |
-Name <string[]>
중지할 서비스의 서비스 이름을 지정합니다. 와일드카드를 사용할 수 있습니다.
매개 변수 이름은 선택 사항입니다. "Name" 또는 해당 별칭("ServiceName")을 사용하거나 매개 변수 이름을 생략할 수 있습니다.
필수 여부 |
true |
위치 |
1 |
기본값 |
|
파이프라인 입력 적용 여부 |
true (ByValue, ByPropertyName) |
와일드카드 문자 적용 여부 |
false |
-PassThru
서비스를 나타내는 개체를 반환합니다. 기본적으로 이 cmdlet에서는 출력을 생성하지 않습니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-Confirm
명령을 실행하기 전에 확인 메시지를 표시합니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-WhatIf
명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
<CommonParameters>
이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_commonparameters.
입력 및 출력
입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.
입력 |
System.ServiceProcess.ServiceController 또는 System.String 서비스 개체나 서비스 이름이 포함된 문자열을 Stop-Service로 파이프할 수 있습니다. |
출력 |
없음 또는 System.ServiceProcess.ServiceController PassThru 매개 변수를 사용하는 경우 Stop-Service는 서비스를 나타내는 System.ServiceProcess.ServiceController 개체를 생성합니다. 그렇지 않으면 아무 출력도 생성하지 않습니다. |
참고
또한 해당 기본 제공 별칭("spsv")으로 Stop-Service를 참조할 수 있습니다. 자세한 내용은 about_Aliases를 참조하십시오.
Stop-Service는 현재 사용자가 서비스를 제어할 수 있는 권한을 가진 경우에만 서비스를 제어할 수 있습니다. 따라서 명령이 제대로 작동하지 않는 경우 필요한 권한이 없을 수 있습니다.
사용자 시스템의 서비스에 대한 서비스 이름 및 표시 이름을 찾으려면 "Get-Service"를 입력하십시오. 서비스 이름은 Name 열에 나타나고 표시 이름은 DisplayName 열에 나타납니다.
예 1
C:\PS>stop-service sysmonlog
설명
-----------
이 명령은 로컬 컴퓨터의 성능 로그 및 알림(SysmonLog) 서비스를 중지합니다.
예 2
C:\PS>get-service -displayname telnet | stop-service
설명
-----------
이 명령은 로컬 컴퓨터의 Telnet 서비스를 중지합니다. 먼저 Get-Service cmdlet을 사용하여 Telnet 서비스를 나타내는 개체를 가져옵니다. 파이프라인 연산자(|)는 Stop-Service cmdlet으로 개체를 파이프합니다. Stop-Service cmdlet은 서비스를 중지합니다.
예 3
C:\PS>get-service iisadmin | format-list -property name, dependentservices
C:PS>stop-service iisadmin -force -confirm
설명
-----------
Stop-Service 명령은 로컬 컴퓨터의 IISAdmin 서비스를 중지합니다. 이 서비스를 중지하면 IISAdmin 서비스에 종속된 서비스도 중지하므로 IISAdmin 서비스에 종속된 서비스를 나열하는 명령을 Stop-Service 명령 앞에 두는 것이 좋습니다.
첫 번째 명령은 IISAdmin에 종속된 서비스를 나열합니다. 이 명령은 Get-Service cmdlet을 사용하여 IISAdmin 서비스를 나타내는 개체를 가져옵니다. 파이프라인 연산자(|)는 결과를 Format-List cmdlet으로 전달합니다. 이 명령은 Format-List의 Property 매개 변수를 사용하여 서비스의 Name 및 DependentServices 속성만 나열합니다.
두 번째 명령은 IISAdmin 서비스를 중지합니다. Force 매개 변수는 종속 서비스가 있는 서비스를 중지하는 데 필요합니다. 이 명령은 Confirm 매개 변수를 사용하여 각 서비스를 중지하기 전에 사용자의 확인을 요청합니다.
참고 항목
개념
Get-Service
Suspend-Service
Start-Service
Restart-Service
Resume-Service
Set-Service
New-Service