New-Service

Синтаксис

Default (По умолчанию)

New-Service
    [-Name] <String>
    [-BinaryPathName] <String>
    [-DisplayName <String>]
    [-Description <String>]
    [-SecurityDescriptorSddl <String>]
    [-StartupType <ServiceStartupType>]
    [-Credential <PSCredential>]
    [-DependsOn <String[]>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Описание

Примеры

Пример 1. Создание службы

New-Service -Name "TestService" -BinaryPathName 'C:\WINDOWS\System32\svchost.exe -k netsvcs'

Пример 2. Создание службы, включающей описание, тип запуска и отображаемое имя

$params = @{
  Name = "TestService"
  BinaryPathName = 'C:\WINDOWS\System32\svchost.exe -k netsvcs'
  DependsOn = "NetLogon"
  DisplayName = "Test Service"
  StartupType = "Manual"
  Description = "This is a test service."
}
New-Service @params

Пример 3. Просмотр новой службы

Get-CimInstance -ClassName Win32_Service -Filter "Name='testservice'"

ExitCode  : 0
Name      : testservice
ProcessId : 0
StartMode : Auto
State     : Stopped
Status    : OK

Пример 4. Установка средства securityDescriptor службы при создании.

$SDDL = "D:(A;;CCLCSWRPWPDTLOCRRC;;;SY)(A;;CCDCLCSWRPWPDTLOCRSDRCWDWO;;;BA)(A;;CCLCSWLOCRRC;;;SU)"
$params = @{
  BinaryPathName = 'C:\WINDOWS\System32\svchost.exe -k netsvcs'
  DependsOn = "NetLogon"
  DisplayName = "Test Service"
  StartupType = "Manual"
  Description = "This is a test service."
  SecurityDescriptorSddl = $SDDL
}
New-Service @params

Параметры

-BinaryPathName

Указывает путь исполняемого файла для службы. Этот параметр является обязательным.

Полный путь к двоичному файлу службы. Если путь содержит пробел, он должен быть процитирован таким образом, чтобы он правильно интерпретировался. Например, D:\my share\myservice.exe следует указать как '"D:\my share\myservice.exe"'.

Путь также может включать аргументы для службы автозапуска. Например: '"D:\my share\myservice.exe" arg1 arg2'. Эти аргументы передаются в точку входа службы.

Дополнительные сведения см. в параметре lpBinaryPathName API CreateServiceW.

Свойства параметров

Наборы параметров

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

Свойства параметров

Наборы параметров

-Credential

Указывает учетную запись, используемую службой в качестве учетной записи входа в службу.

Введите имя пользователя, например User01 или Domain01\User01, или введите объект PSCredential, например один, созданный командлетом Get-Credential. При вводе имени пользователя этот командлет запрашивает пароль.

Учетные данные хранятся в объекте PSCredential, а пароль хранится в виде SecureString.

Свойства параметров

Наборы параметров

-DependsOn

Указывает имена других служб, от которых зависит новая служба. Чтобы ввести несколько имен служб, используйте запятую для разделения имен.

Свойства параметров

Наборы параметров

-Description

Указывает описание службы.

Свойства параметров

Наборы параметров

-DisplayName

Указывает отображаемое имя службы.

Свойства параметров

Наборы параметров

-Name

Указывает имя службы. Этот параметр является обязательным.

Свойства параметров

Наборы параметров

-SecurityDescriptorSddl

Указывает SecurityDescriptor для службы в формате Sddl.

Свойства параметров

Наборы параметров

-StartupType

Задает тип запуска службы. Допустимые значения для этого параметра:

• автоматическое — служба запускается или была запущена операционной системой при запуске системы. Если служба автоматического запуска зависит от службы, запущенной вручную, служба вручную запускается автоматически при запуске системы.
• AutomaticDelayedStart — запускается вскоре после загрузки системы.
• Отключено — службу нельзя запустить ни пользователем, ни приложением.
• InvalidValue — это значение не поддерживается. Использование этого значения приводит к ошибке.
• Вручную. Служба запускается только вручную пользователем, через Менеджер управления службами, или с помощью приложения.

Значение по умолчанию — автоматические.

Свойства параметров

Наборы параметров

-WhatIf

Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.

Свойства параметров

Наборы параметров

CommonParameters

Входные данные

None

Выходные данные

ServiceController

Примечания

Связанные ссылки

• Invoke-Command
• Get-Service
• Restart-Service
• Сервис резюме
• Set-Service
• Start-Service
• Остановить службу
• Приостановить службу
• Удалить-Службу