Restart-Service

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

Syntax

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

이 명령은 로컬 컴퓨터의 WMI(Windows Management Instrumentation)(WinMgmt) 서비스를 다시 시작합니다.

예제 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으로 시작하는 서비스를 나타내는 개체를 가져옵니다. 파이프라인 연산자(|)는 서비스 개체를 cmdlet으로 Where-Object 보내며, 중지된 상태의 서비스만 선택합니다. 다른 파이프라인 연산자는 선택한 서비스를 .에 Restart-Service보냅니다.

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

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인을 요청합니다.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

다시 시작할 서비스의 표시 이름을 지정합니다. 와일드카드 문자를 사용할 수 있습니다.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-Exclude

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

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Include

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

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-InputObject

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

Type:ServiceController[]
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Name

다시 시작할 서비스의 서비스 이름을 지정합니다.

Type:String[]
Aliases:ServiceName
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:True

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

cmdlet을 실행할 경우 발생하는 일을 표시합니다. cmdlet은 실행되지 않습니다.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

입력

System.ServiceProcess.ServiceController, System.String

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

출력

None, System.ServiceProcess.ServiceController

이 cmdlet은 PassThru 매개 변수를 지정하는 경우 다시 시작한 서비스를 나타내는 System.ServiceProcess.ServiceController 개체를 생성합니다. 그러지 않으면 이 cmdlet에서 출력이 생성되지 않습니다.

참고

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

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