Restart-Service
하나 이상의 서비스를 중지한 다음 시작합니다.
구문
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
Restart-Service cmdlet은 지정된 서비스에 대해 중지 메시지와 시작 메시지를 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이 명령은 컴퓨터에서 중지된 모든 네트워크 서비스를 시작합니다.
이 명령은 Get-Service cmdlet을 사용하여 서비스 이름이 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 |
입력
System.ServiceProcess.ServiceController, System.String
서비스 개체 또는 서비스 이름이 포함된 문자열을 이 cmdlet으로 파이프할 수 있습니다.
출력
None, System.ServiceProcess.ServiceController
이 cmdlet은 PassThru 매개 변수를 지정하는 경우 다시 시작한 서비스를 나타내는 System.ServiceProcess.ServiceController 개체를 생성합니다. 그렇지 않으면 이 cmdlet은 출력을 생성하지 않습니다.
참고
- Restart-Service 현재 사용자에게 이 작업을 수행할 권한이 있는 경우에만 서비스를 제어할 수 있습니다. 명령이 제대로 작동하지 않으면 필요한 권한이 없을 수 있습니다.
- 시스템에서 서비스 이름을 찾고 서비스 이름을 표시하려면 Get-Service"를 입력합니다. 서비스 이름은 이름 열에 나타나고 표시 이름은 DisplayName 열에 표시됩니다.