다음을 통해 공유


Stop-Service

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

구문

InputObject (기본값)

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

Default

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

DisplayName

Stop-Service
    -DisplayName <String[]>
    [-Force]
    [-NoWait]
    [-PassThru]
    [-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 서비스에 종속된 서비스를 나열하는 명령을 사용하여 서비스 중지 앞에 두는 것이 가장 좋습니다.

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

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

매개 변수

-Confirm

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

매개 변수 속성

형식:SwitchParameter
Default value:False
와일드카드 지원:False
DontShow:False
별칭:cf(cf)

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-DisplayName

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

매개 변수 속성

형식:

String[]

Default value:None
와일드카드 지원:True
DontShow:False

매개 변수 집합

DisplayName
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Exclude

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

매개 변수 속성

형식:

String[]

Default value:None
와일드카드 지원:True
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Force

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

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Include

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

매개 변수 속성

형식:

String[]

Default value:None
와일드카드 지원:True
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-InputObject

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

매개 변수 속성

형식:

ServiceController[]

Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

InputObject
Position:0
필수:True
파이프라인의 값:True
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Name

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

매개 변수 속성

형식:

String[]

Default value:None
와일드카드 지원:True
DontShow:False
별칭:서비스 이름

매개 변수 집합

Default
Position:0
필수:True
파이프라인의 값:True
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-NoWait

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

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-PassThru

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

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-WhatIf

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

매개 변수 속성

형식:SwitchParameter
Default value:False
와일드카드 지원:False
DontShow:False
별칭:위스콘신

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

System.ServiceProcess.ServiceController, System.String

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

출력

None, System.ServiceProcess.ServiceController

이 cmdlet은 PassThru 매개 변수를 사용하는 경우 서비스를 나타내는 System.ServiceProcess.ServiceController 개체를 생성합니다. 그렇지 않으면 이 cmdlet은 출력을 생성하지 않습니다.

참고

  • spsv기본 제공 별칭으로 Stop-Service 참조할 수도 있습니다. 자세한 내용은 about_Aliases 참조하세요.

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

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