실행 중인 하나 이상의 서비스를 중지합니다.

구문

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 매개 변수를 사용하여 각 서비스를 중지하기 전에 사용자의 확인을 요청합니다.

참고 항목



목차