다음을 통해 공유

Restart-Service

  • 참조
모듈:
Microsoft.PowerShell.Management

하나 이상의 서비스를 중지한 다음 다시 시작합니다.

구문

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

Description

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

cmdlet은 Restart-Service 지정된 서비스에 대해 중지 메시지와 시작 메시지를 Windows 서비스 컨트롤러로 보냅니다. 서비스가 이미 중지된 경우 오류를 알리지 않고 시작됩니다. 서비스 이름 또는 표시 이름으로 서비스를 지정하거나 InputObject 매개 변수를 사용하여 다시 시작하려는 각 서비스를 나타내는 개체를 전달할 수 있습니다.

예제

예제 1: 로컬 컴퓨터에서 서비스 다시 시작

PS C:\> Restart-Service -Name winmgmt

이 명령은 로컬 컴퓨터에서 WinMgmt(Windows Management Instrumentation Service)를 다시 시작합니다.

예제 2: 서비스 제외

PS C:\> Restart-Service -DisplayName "net*" -Exclude "net logon"

이 명령은 Net 로그온 서비스를 제외하고 Net으로 시작하는 표시 이름이 있는 서비스를 다시 시작합니다.

예제 3: 중지된 모든 네트워크 서비스 시작

PS C:\> Get-Service -Name "net*" | Where-Object {$_.Status -eq "Stopped"} | Restart-Service

이 명령은 컴퓨터에서 중지된 모든 네트워크 서비스를 시작합니다.

이 명령은 cmdlet을 Get-Service 사용하여 서비스 이름이 net으로 시작하는 서비스를 나타내는 개체를 가져옵니다. 파이프라인 연산자(|)는 서비스 개체 Where-Object 를 cmdlet에 보내며, 이 cmdlet은 중지된 상태의 서비스만 선택합니다. 다른 파이프라인 연산자가 선택한 서비스를 .에 Restart-Service보냅니다.

실제로 WhatIf 매개 변수를 사용하여 명령을 실행하기 전에 명령의 효과를 확인합니다.

매개 변수

-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

사용자 확인을 요청하지 않고 명령을 강제 실행합니다.

형식: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

-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 개체를 반환합니다.

참고

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

  • Restart-Service 는 현재 사용자에게 이 작업을 수행할 수 있는 권한이 있는 경우에만 서비스를 제어할 수 있습니다. 따라서 명령이 제대로 작동하지 않는 경우 필요한 권한이 없을 수 있습니다.
  • 서비스 이름을 찾고 시스템에서 서비스의 이름을 표시하려면 "를 입력 Get-Service합니다. 서비스 이름은 이름 열에 표시되고 표시 이름은 DisplayName 열에 표시됩니다.