다음을 통해 공유

Stop-Service

  • 참조
모듈:
Microsoft.PowerShell.Management

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

구문

Stop-Service
    [-Force]
    [-NoWait]
    [-InputObject] <ServiceController[]>
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Stop-Service
    [-Force]
    [-NoWait]
    [-Name] <String[]>
    [-PassThru]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Stop-Service
    [-Force]
    [-NoWait]
    [-PassThru]
    -DisplayName <String[]>
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Stop-Service cmdlet은 지정된 각 서비스에 대해 Windows 서비스 컨트롤러에 중지 메시지를 보냅니다. 서비스 이름 또는 표시 이름으로 서비스를 지정하거나 InputObject 매개 변수를 사용하여 중지하려는 서비스를 나타내는 서비스 개체를 전달할 수 있습니다.

예제

예제 1: 로컬 컴퓨터에서 서비스 중지

PS C:\> Stop-Service -Name "sysmonlog"

이 명령은 로컬 컴퓨터에서 성능 로그 및 경고(SysmonLog) 서비스를 중지합니다.

예제 2: 표시 이름을 사용하여 서비스 중지

PS C:\> Get-Service -DisplayName "telnet" | Stop-Service

이 명령은 로컬 컴퓨터에서 텔넷 서비스를 중지합니다. 이 명령은 Get-Service 사용하여 텔넷 서비스를 나타내는 개체를 가져옵니다. 파이프라인 연산자(|)는 개체를 Stop-Service파이프하여 서비스를 중지합니다.

예제 3: 종속 서비스가 있는 서비스 중지

PS C:\> Get-Service -Name "iisadmin" | Format-List -Property Name, DependentServices
PS C:\> Stop-Service -Name "iisadmin" -Force -Confirm

다음은 로컬 컴퓨터에서 IISAdmin 서비스를 중지하는 예제입니다. 이 서비스를 중지하면 IISAdmin 서비스에 종속된 서비스도 중지되므로 IISAdmin 서비스에 종속된 서비스를 나열하는 명령을 사용하여 Stop-Service 앞에 오는 것이 가장 좋습니다.

첫 번째 명령은 IISAdmin에 의존하는 서비스를 나열합니다. Get-Service 사용하여 IISAdmin 서비스를 나타내는 개체를 가져옵니다. 파이프라인 연산자(|)는 결과를 Format-List cmdlet에 전달합니다. 이 명령은 Format-ListProperty 매개 변수를 사용하여 서비스의 Name 및 DependentServices 속성만 나열합니다.

두 번째 명령은 IISAdmin 서비스를 중지합니다. 종속 서비스가 있는 서비스를 중지하려면 Force 매개 변수가 필요합니다. 이 명령은 Confirm 매개 변수를 사용하여 각 서비스를 중지하기 전에 사용자에게 확인을 요청합니다.

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

형식:SwitchParameter
별칭:cf
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DisplayName

중지할 서비스의 표시 이름을 지정합니다. 와일드카드 문자가 허용됩니다.

형식:String[]
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:True

-Exclude

이 cmdlet에서 생략하는 서비스를 지정합니다. 이 매개 변수의 값은 Name 매개 변수를 한정합니다. 이름 요소 또는 패턴(예: s*)을 입력합니다. 와일드카드 문자가 허용됩니다.

형식:String[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:True

-Force

해당 서비스에 종속 서비스가 있는 경우에도 cmdlet이 서비스를 중지하도록 합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Include

이 cmdlet이 중지되는 서비스를 지정합니다. 이 매개 변수의 값은 Name 매개 변수를 한정합니다. 이름 요소 또는 패턴(예: s*)을 입력합니다. 와일드카드 문자가 허용됩니다.

형식:String[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:True

-InputObject

중지할 서비스를 나타내는 ServiceController 개체를 지정합니다. 개체가 포함된 변수를 입력하거나 개체를 가져오는 명령이나 식을 입력합니다.

형식:ServiceController[]
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Name

중지할 서비스의 서비스 이름을 지정합니다. 와일드카드 문자가 허용됩니다.

형식:String[]
별칭:ServiceName
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:True

-NoWait

이 cmdlet에서 대기 없음 옵션을 사용한다는 것을 나타냅니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PassThru

서비스를 나타내는 개체를 반환합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

형식:SwitchParameter
별칭:wi
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

ServiceController

서비스 개체를 이 cmdlet으로 파이프할 수 있습니다.

String

서비스 이름이 포함된 문자열을 이 cmdlet으로 파이프할 수 있습니다.

출력

None

기본적으로 이 cmdlet은 출력을 반환하지 않습니다.

ServiceController

PassThru 매개 변수를 사용하는 경우 이 cmdlet은 서비스를 나타내는 ServiceController 개체를 반환합니다.

참고

Windows PowerShell에는 Stop-Service다음과 같은 별칭이 포함되어 있습니다.

  • spsv

Stop-Service 현재 사용자에게 이 작업을 수행할 권한이 있는 경우에만 서비스를 제어할 수 있습니다. 명령이 제대로 작동하지 않으면 필요한 권한이 없을 수 있습니다.

시스템에서 서비스 이름을 찾고 서비스 이름을 표시하려면 Get-Service입력합니다. 서비스 이름은 이름 열에 표시되고 표시 이름은 DisplayName 열에 표시됩니다.