Share via

Set-Service

  • 참조
모듈:
Microsoft.PowerShell.Management

서비스를 시작, 중지 및 일시 중단하고 해당 속성을 변경합니다.

Syntax

Set-Service
   [-ComputerName <String[]>]
   [-Name] <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

cmdlet은 Set-Service 상태, 설명, DisplayName 및 StartupType과 같은 서비스의 속성을 변경합니다. Set-Service 는 서비스를 시작, 중지, 일시 중단 또는 일시 중지할 수 있습니다. 서비스를 식별하려면 서비스 이름을 입력하거나 서비스 개체를 제출합니다. 또는 파이프라인 Set-Service아래로 서비스 이름 또는 서비스 개체를 보냅니다.

예제

예제 1: 표시 이름 변경

이 예제에서는 서비스의 표시 이름이 변경됩니다. 원래 표시 이름을 보려면 .를 사용합니다 Get-Service.

Set-Service -Name LanmanWorkstation -DisplayName "LanMan Workstation"

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를 지정합니다. StartupType 매개 변수는 서비스를 자동으로 설정합니다.

Get-Service는 Name 매개 변수를 사용하여 BITS 서비스를 지정하고 개체를 파이프라인 아래로 보냅니다. Select-Object는 Property 매개 변수를 사용하여 BITS 서비스의 상태 표시합니다.

예제 3: 서비스에 대한 설명 변경

다음은 BITS 서비스의 설명을 변경하고 결과를 표시하는 예제입니다.

이 Get-CimInstance cmdlet은 서비스의 설명이 포함된 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...

Set-Service는 Name 매개 변수를 사용하여 서비스 WinRM을 지정합니다. Status 매개 변수는 실행 중인 값을 사용하여 서비스를 시작합니다. PassThru 매개 변수는 결과를 표시하는 ServiceController 개체를 출력합니다.

예제 5: 서비스 일시 중단

이 예제에서는 파이프라인을 사용하여 서비스를 일시 중지합니다.

Get-Service -Name Schedule | Set-Service -Status Paused

Get-Service는 Name 매개 변수를 사용하여 Schedule 서비스를 지정하고 개체를 파이프라인 아래로 보냅니다. Set-Service는 Status 매개 변수를 사용하여 서비스를 일시 중지됨으로 설정합니다.

예제 6: 서비스 중지

이 예제에서는 변수를 사용하여 서비스를 중지합니다.

$S = Get-Service -Name Schedule
Set-Service -InputObject $S -Status Stopped

Get-Service 는 Name 매개 변수를 사용하여 서비스인 Schedule을 지정합니다. 개체는 변수 $S에 저장됩니다. Set-Service 에서는 InputObject 매개 변수를 사용하고 저장된 $S개체를 지정합니다. Status 매개 변수는 서비스를 중지됨으로 설정합니다.

예제 7: 여러 서비스에 대한 시작 유형 설정

cmdlet은 Set-Service 한 번에 하나의 서비스 이름만 허용합니다. 그러나 여러 서비스를 파이프하여 Set-Service 여러 서비스의 구성을 변경할 수 있습니다.

Get-Service SQLWriter,spooler |
    Set-Service -StartupType Automatic -PassThru |
    Select-Object Name, StartType

Name      StartType
----      ---------
spooler   Automatic
SQLWriter Automatic

매개 변수

-ComputerName

하나 이상의 컴퓨터를 지정합니다. 원격 컴퓨터의 경우 NetBIOS 이름, IP 주소 또는 정규화된 do기본 이름을 입력합니다. ComputerName 매개 변수를 지정하지 않으면 명령이 로컬 컴퓨터에서 실행됩니다.

이 매개 변수는 PowerShell 원격을 사용하지 않습니다. 컴퓨터가 원격 명령을 실행하도록 구성되지 않은 경우에도 ComputerName 매개 변수를 사용할 수 있습니다.

Type:String[]
Aliases:cn
Position:Named
Default value:Local computer
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

를 실행 Set-Service하기 전에 확인 메시지를 표시합니다.

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

-Description

서비스에 대한 새 설명을 지정합니다.

서비스 설명은 컴퓨터 관리, 서비스에 표시됩니다. Description은 ServiceController 개체의 속성이 Get-Service아닙니다. 서비스 설명을 보려면 서비스를 나타내는 Win32_Service 개체를 반환하는 데 사용합니다Get-CimInstance.

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

-DisplayName

서비스의 새 표시 이름을 지정합니다.

참고 항목

일반적으로 Set-Service 드라이버가 아닌 Windows 서비스에서만 작동합니다. 그러나 드라이버의 이름을 지정하는 경우 드라이버를 Set-Service 대상으로 지정할 수 있습니다.

Type:String
Aliases:DN
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

변경할 서비스를 나타내는 ServiceController 개체를 지정합니다. 개체가 포함된 변수를 입력하거나 명령과 같이 Get-Service 개체를 가져오는 명령이나 식을 입력합니다. 파이프라인을 사용하여 서비스 개체 Set-Service를 .에 보낼 수 있습니다.

Type:ServiceController
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

변경할 서비스의 서비스 이름을 지정합니다. 와일드카드 문자는 허용되지 않습니다. 파이프라인을 사용하여 서비스 이름을 Set-Service.에 보낼 수 있습니다.

참고 항목

일반적으로 Set-Service 드라이버가 아닌 Windows 서비스에서만 작동합니다. 그러나 드라이버의 이름을 지정하는 경우 드라이버를 Set-Service 대상으로 지정할 수 있습니다.

Type:String
Aliases:ServiceName, SN
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

변경된 서비스를 나타내는 ServiceController 개체를 반환합니다. 기본적으로 출력은 Set-Service 생성하지 않습니다.

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

-StartupType

서비스의 시작 유형을 설정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • 자동 - 서비스가 시스템 시작 시 운영 체제에서 시작되거나 시작되었습니다. 자동으로 시작되는 서비스가 수동으로 시작되는 서비스에 종속된 경우 수동으로 시작되는 서비스도 시스템 시작 시 자동으로 시작됩니다.
  • 사용 안 함 - 서비스를 사용할 수 없으며 사용자 또는 애플리케이션에서 시작할 수 없습니다.
  • 수동 - 서비스는 수동, 사용자, 서비스 제어 관리자 사용 또는 애플리케이션에서만 시작됩니다.
  • 부팅 - 서비스가 시스템 로더에서 시작한 디바이스 드라이버임을 나타냅니다. 이 값은 디바이스 드라이버에만 유효합니다.
  • 시스템 - 서비스가 'IOInitSystem()' 함수에서 시작한 디바이스 드라이버임을 나타냅니다. 이 값은 디바이스 드라이버에만 유효합니다.

기본값은 Automatic입니다.

Type:ServiceStartMode
Aliases:StartMode, SM, ST
Accepted values:Boot, System, Automatic, Manual, Disabled
Position:Named
Default value:Automatic
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Status

서비스의 상태 지정합니다.

이 매개 변수에 허용되는 값은 다음과 같습니다.

  • 일시 중지되었습니다. 서비스를 일시 중단합니다.
  • 실행 중. 서비스를 시작합니다.
  • 중지됨. 서비스를 중지합니다.
Type:String
Accepted values:Paused, Running, Stopped
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

실행될 경우 Set-Service 어떤 일이 발생하는지 표시합니다. cmdlet이 실행되지 않습니다.

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

입력

ServiceController

서비스 개체를 이 cmdlet으로 파이프할 수 있습니다.

String

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

출력

None

기본적으로 이 cmdlet은 출력을 반환하지 않습니다.

ServiceController

PassThru 매개 변수를 사용하는 경우 이 cmdlet은 ServiceController 개체를 반환합니다.

참고

Set-Service 에는 상승된 권한이 필요합니다. 관리자 권한으로 실행 옵션을 사용합니다.

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

서비스의 서비스 이름 또는 표시 이름을 찾으려면 .를 사용합니다 Get-Service. 서비스 이름은 이름 열에 있고 표시 이름은 DisplayName 열에 있습니다.