Set-Service
서비스를 시작, 중지 및 일시 중단하고 해당 속성을 변경합니다.
구문
Set-Service
[-Name] <String>
[-ComputerName <String[]>]
[-DisplayName <String>]
[-Description <String>]
[-StartupType <ServiceStartMode>]
[-Status <String>]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Set-Service
[-ComputerName <String[]>]
[-DisplayName <String>]
[-Description <String>]
[-StartupType <ServiceStartMode>]
[-Status <String>]
[-InputObject <ServiceController>]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
Set-Service cmdlet은 상태, 설명, DisplayName및 StartupType같은 서비스의 속성을 변경합니다.
Set-Service 서비스를 시작, 중지, 일시 중단 또는 일시 중지할 수 있습니다. 서비스를 식별하려면 서비스 이름을 입력하거나 서비스 개체를 제출합니다. 또는 파이프라인 아래로 서비스 이름 또는 서비스 개체를 보내 Set-Service.
예제
예제 1: 표시 이름 변경
이 예제에서는 서비스의 표시 이름이 변경됩니다. 원래 표시 이름을 보려면 Get-Service사용합니다.
Set-Service -Name LanmanWorkstation -DisplayName "LanMan Workstation"예제 2: 서비스의 시작 유형 변경
이 예제에서는 서비스의 시작 유형을 변경하는 방법을 보여줍니다.
Set-Service -Name BITS -StartupType Automatic
Get-Service BITS | Select-Object -Property Name, StartType, Status
Name StartType Status
---- --------- ------
BITS Automatic Running
Set-Service
Name 매개 변수를 사용하여 서비스의 이름 BITS지정합니다.
Get-Service
Name 매개 변수를 사용하여 BITS 서비스를 지정하고 개체를 파이프라인 아래로 보냅니다.
Select-Object
속성 매개 변수를 사용하여 BITS 서비스의 상태를 표시합니다.
예제 3: 서비스에 대한 설명 변경
다음은 BITS 서비스의 설명을 변경하고 결과를 표시하는 예제입니다.
Get-CimInstance cmdlet은 서비스의 Description포함하는 Win32_Service 개체를 반환하기 때문에 사용됩니다.
Get-CimInstance Win32_Service -Filter 'Name = "BITS"' | Format-List Name, Description
Name : BITS
Description : Transfers files in the background using idle network bandwidth. If the service is
disabled, then any applications that depend on BITS, such as Windows Update or MSN
Explorer, will be unable to automatically download programs and other information.
Set-Service -Name BITS -Description "Transfers files in the background using idle network bandwidth."
Get-CimInstance Win32_Service -Filter 'Name = "BITS"' | Format-List Name, Description
Name : BITS
Description : Transfers files in the background using idle network bandwidth.
Get-CimInstance 개체를 파이프라인 아래로 보내 Format-List 서비스의 이름과 설명을 표시합니다. 비교를 위해 설명이 업데이트되기 전과 후에 명령이 실행됩니다.
Set-Service
Name 매개 변수를 사용하여 BITS 서비스를 지정합니다.
Description 매개 변수는 서비스 설명에 대한 업데이트된 텍스트를 지정합니다.
예제 4: 서비스 시작
이 예제에서는 서비스가 시작됩니다.
Set-Service -Name WinRM -Status Running -PassThru
Status Name DisplayName
------ ---- -----------
Running WinRM Windows Remote Management (WS-Manag...예제 5: 서비스 일시 중단
이 예제에서는 파이프라인을 사용하여 서비스를 일시 중지합니다.
Get-Service -Name Schedule | Set-Service -Status Paused
Get-Service
Name 매개 변수를 사용하여 Schedule 서비스를 지정하고 개체를 파이프라인 아래로 보냅니다.
예제 6: 서비스 중지
이 예제에서는 변수를 사용하여 서비스를 중지합니다.
$S = Get-Service -Name Schedule
Set-Service -InputObject $S -Status Stopped$S저장됩니다.
Set-Service
InputObject 매개 변수를 사용하고 $S저장된 개체를 지정합니다.
매개 변수
-ComputerName
하나 이상의 컴퓨터를 지정합니다. 원격 컴퓨터의 경우 NetBIOS 이름, IP 주소 또는 정규화된 도메인 이름을 입력합니다. ComputerName 매개 변수를 지정하지 않으면 명령이 로컬 컴퓨터에서 실행됩니다.
이 매개 변수는 PowerShell 원격을 사용하지 않습니다. 컴퓨터가 원격 명령을 실행하도록 구성되지 않은 경우에도 ComputerName 매개 변수를 사용할 수 있습니다.
| 형식: | String[] |
| 별칭: | cn |
| Position: | Named |
| Default value: | Local computer |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Confirm
Set-Service실행하기 전에 확인 메시지를 표시합니다.
| 형식: | SwitchParameter |
| 별칭: | cf |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Description
서비스에 대한 새 설명을 지정합니다.
서비스 설명은 컴퓨터 관리, 서비스나타납니다.
설명Get-ServiceServiceController 개체의 속성이 아닙니다. 서비스 설명을 보려면 서비스를 나타내는 Win32_Service 개체를 반환하는 Get-CimInstance 사용합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DisplayName
서비스의 새 표시 이름을 지정합니다.
| 형식: | String |
| 별칭: | DN |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-InputObject
변경할 서비스를 나타내는 ServiceController 개체를 지정합니다. 개체가 포함된 변수를 입력하거나 Get-Service 명령과 같이 개체를 가져오는 명령이나 식을 입력합니다. 파이프라인을 사용하여 서비스 개체를 보내 Set-Service수 있습니다.
| 형식: | ServiceController |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Name
변경할 서비스의 서비스 이름을 지정합니다. 와일드카드 문자는 허용되지 않습니다. 파이프라인을 사용하여 Set-Service서비스 이름을 보낼 수 있습니다.
| 형식: | String |
| 별칭: | ServiceName, SN |
| Position: | 0 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-PassThru
변경된 서비스를 나타내는 ServiceController 개체를 반환합니다. 기본적으로 Set-Service 출력을 생성하지 않습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-StartupType
서비스의 시작 모드를 지정합니다.
이 매개 변수에 허용되는 값은 다음과 같습니다.
- 자동
. 시스템이 시작될 때 시작됩니다. - 사용 안 함. 서비스를 시작할 수 없습니다.
- 수동. 사용자 또는 프로그램에서 시작할 때만 시작됩니다.
| 형식: | ServiceStartMode |
| 별칭: | StartMode, SM, ST |
| 허용되는 값: | Automatic, Boot, Disabled, Manual, System |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Status
서비스의 상태를 지정합니다.
이 매개 변수에 허용되는 값은 다음과 같습니다.
- 일시 중지된
. 서비스를 일시 중단합니다. - 실행. 서비스를 시작합니다.
- 중지된. 서비스를 중지합니다.
| 형식: | String |
| 허용되는 값: | Paused, Running, Stopped |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-WhatIf
Set-Service 실행될 경우 어떤 일이 발생하는지 보여줍니다. cmdlet이 실행되지 않습니다.
| 형식: | SwitchParameter |
| 별칭: | wi |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
입력
System.ServiceProcess.ServiceController, System.String
파이프라인을 사용하여 서비스 개체 또는 서비스 이름이 포함된 문자열을 보내 Set-Service수 있습니다.
출력
기본적으로 Set-Service 개체를 반환하지 않습니다.
PassThru 매개 변수를 사용하여 ServiceController 개체를 출력합니다.
참고
Set-Service 상승된 권한이 필요합니다.
관리자 권한으로 실행 옵션을 사용합니다.
Set-Service 현재 사용자에게 서비스를 관리할 수 있는 권한이 있는 경우에만 서비스를 제어할 수 있습니다. 명령이 제대로 작동하지 않으면 필요한 권한이 없을 수 있습니다.
서비스의 서비스 이름 또는 표시 이름을 찾으려면 Get-Service사용합니다. 서비스 이름은 이름 열에 있으며 표시 이름은 DisplayName 열에 있습니다.