다음을 통해 공유

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

이 cmdlet은 Windows 플랫폼에서만 사용할 수 있습니다.

cmdlet은 Stop-Service 지정된 각 서비스에 대해 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에 의존하는 서비스를 나열합니다. IISAdmin 서비스를 나타내는 개체를 가져오는 데 사용합니다 Get-Service . 파이프라인 연산자(|)는 결과를 cmdlet에 Format-List 전달합니다. 이 명령은 서비스의 Name 및 DependentServices 속성만 나열하는 속성 매개 변수 Format-List 를 사용합니다.

두 번째 명령은 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 개체를 반환합니다.

참고

PowerShell에는 다음 별칭이 포함됩니다.Stop-Service

  • Windows:
    • spsv

이 cmdlet은 Windows 플랫폼에서만 사용할 수 있습니다.

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

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