Current File : //usr/lib/python2.7/site-packages/salt/modules/win_service.pyc
�
���^c @@ s� d Z d d l m Z m Z m Z d d l Z d d l Z d d l Z d d l Z d d l Z
d d l Z
d d l m
Z
y: d d l Z d d l Z d d l Z d d l Z e Z Wn e k
r� e Z n Xe j e � Z d Z i
d d 6d d 6d
d 6d d
6d d 6d d 6d d 6d d 6d d 6d d 6d
d 6d d 6d d 6Z i d d 6d d 6d d 6d d
6d d 6d d 6d d! 6d" d# 6d$ d 6d% d& 6d' d( 6Z i d) d 6d* d 6d+ d, 6d- d 6d. d/ 6d0 d1 6d2 d3 6Z i d4 d 6d5 d6 6Z i
d d7 6d d8 6d d9 6d, d: 6d d; 6d< d 6d= d 6d> d 6d? d, 6d@ d 6Z i dA d 6dB d 6dC d 6dD d, 6d dE 6d dF 6d dG 6d, dH 6Z dI � Z dJ � Z! dK � Z" dL � Z# dM � Z$ dN � Z% dO � Z& dP � Z' dQ � Z( dR � Z) dS � Z* dT dU � Z+ dT dV � Z, dT dW � Z- dX � Z. dY � Z/ dZ � Z0 d[ � Z1 d d d d d d d d d d d d d d\ �
Z3 d9 e d] � Z4 d^ � Z5 d_ � Z6 d` � Z7 d d d d d: e dF d d da d e db � Z8 dT dc � Z9 d S(d uS
Windows Service module.
.. versionchanged:: 2016.11.0 - Rewritten to use PyWin32
i ( t absolute_importt unicode_literalst print_functionN( t CommandExecutionErroru serviceu
Kernel Driveri u File System Driveri u Adapter Driveri u Recognizer Driveri u Win32 Own Processi u Win32 Share Processi u Interactivei u kernelu
filesystemu adapteru
recognizeru ownu shareu Stopu Pause/Continueu Shutdownu Change Parametersu Netbind Changeu Hardware Profile Changeu Power Eventi@ u Session Changei� u Pre-Shutdownu Time Changei u
Trigger Eventi u Stoppedu
Start Pendingu Stop Pendingi u Runningu Continue Pendingi u
Pause Pendingi u Pausedi u No Erroru Service Specific Errori* u bootu systemu autou manualu disabledu Bootu Systemu Autou Manualu Disabledu Ignoreu Normalu Severeu Criticalu ignoreu normalu severeu criticalc C@ s0 t j j j � s t d f St s, t d f St S( u>
Only works on Windows systems with PyWin32 installed
u1 Module win_service: module only works on Windows.u0 Module win_service: failed to load win32 modules( t saltt utilst platformt
is_windowst Falset HAS_WIN32_MODSt __virtualname__( ( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_service.pyt __virtual__] s
c C@ s� t | � } x� | d | k r� t j � | k r� | d } | rK | d n d } | d k rf d } n | d k r{ d } n t j | � t | � } q W| S( uW
Helper function that will wait for the status of the service to match the
provided status before an end time expires. Used for service stop and start
.. versionadded:: 2017.7.9,2018.3.4
Args:
service_name (str):
The name of the service
end_time (float):
A future time. e.g. time.time() + 10
service_states (list):
Services statuses to wait for as returned by info()
Returns:
dict: A dictionary containing information about the service.
:codeauthor: Damon Atkins <https://github.com/damon-atkins>
u Statusu Status_WaitHinti� i i i
( t infot timet sleep( t service_namet end_timet service_statest info_resultst wait_time( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_service.pyt _status_waitj s %
c C@ sV t j d � } x1 | j | � d k rB | j d � j d � } q Wd j | � } | S( uP
Helper function to properly format the path to the binary for the service
Must be wrapped in double quotes to account for paths that have spaces. For
example:
``"C:\Program Files\Path\to\bin.exe"``
Args:
cmd (str): Full path to the binary
Returns:
str: Properly quoted path to the binary
u ^(\"|').*|.*(\"|')$u "u 'u "{0}"N( t ret compilet matcht Nonet stript format( t cmdt pattern( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_service.pyt
_cmd_quote� s
c C@ s[ t � } t � } x< | D]4 } t | d � d d k r | j | d � q q Wt | � S( u�
Return a list of enabled services. Enabled is defined as a service that is
marked to Auto Start.
Returns:
list: A list of enabled services
CLI Example:
.. code-block:: bash
salt '*' service.get_enabled
u ServiceNameu StartTypeu Auto( u Auto( t
_get_servicest setR t addt sorted( t raw_servicest servicest service( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_service.pyt get_enabled� s
c C@ s[ t � } t � } x< | D]4 } t | d � d d k r | j | d � q q Wt | � S( u
Return a list of disabled services. Disabled is defined as a service that is
marked 'Disabled' or 'Manual'.
Returns:
list: A list of disabled services.
CLI Example:
.. code-block:: bash
salt '*' service.get_disabled
u ServiceNameu StartTypeu Manualu Disabled( u Manualu Disabled( R R R R R! ( R" R# R$ ( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_service.pyt get_disabled� s
c C@ s4 x- t � D]" } | j � | j � k r
t Sq
Wt S( u-
Check if a service is available on the system.
Args:
name (str): The name of the service to check
Returns:
bool: ``True`` if the service is available, ``False`` otherwise
CLI Example:
.. code-block:: bash
salt '*' service.available <service name>
( t get_allt lowert TrueR ( t nameR$ ( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_service.pyt available� s c C@ s
| t � k S( u
The inverse of service.available.
Args:
name (str): The name of the service to check
Returns:
bool: ``True`` if the service is missing, ``False`` otherwise
CLI Example:
.. code-block:: bash
salt '*' service.missing <service name>
( R' ( R* ( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_service.pyt missing� s c C@ sg t j d d t j � } z: y t j | � } Wn t k
rP t j | � } n XWd t j | � X| S( u7
Returns a list of all services on the system.
N( t win32servicet
OpenSCManagerR t SC_MANAGER_ENUMERATE_SERVICEt EnumServicesStatusExt AttributeErrort EnumServicesStatust CloseServiceHandle( t
handle_scmR# ( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_service.pyR s
c C@ s> t � } t � } x | D] } | j | d � q Wt | � S( u�
Return all installed services
Returns:
list: Returns a list of all services on the system.
CLI Example:
.. code-block:: bash
salt '*' service.get_all
u ServiceName( R R R R! ( R# t retR$ ( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_service.pyR' s
c G@ s� t � } t � } xt | D]l } | rs | d | k s[ | d | k s[ | d j � | k r� | d | | d <q� q | d | | d <q W| S( uG
The Display Name is what is displayed in Windows when services.msc is
executed. Each Display Name has an associated Service Name which is the
actual name of the service. This function allows you to discover the
Service Name by returning a dictionary of Display Names and Service Names,
or filter by adding arguments of Display Names.
If no args are passed, return a dict of all services where the keys are the
service Display Names and the values are the Service Names.
If arguments are passed, create a dict of Display Names and Service Names
Returns:
dict: A dictionary of display names and service names
CLI Examples:
.. code-block:: bash
salt '*' service.get_service_name
salt '*' service.get_service_name 'Google Update Service (gupdate)' 'DHCP Client'
u DisplayNameu ServiceName( R t dictR( ( t argsR" R# t raw_service( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_service.pyt get_service_name. s
c C@ s� y t j d d t j � } Wn. t j k
rL } t d j | j � � � n Xy1 t j | | t j
t j Bt j Bt j
B� } Wn1 t j k
r� } t d j | | j � � � n Xzm t j | � } t j | � } y t j | t j � } Wn t j k
rd } n Xt j | t j � } Wd t j | � t j | � Xt � } y6 t j d d j | � � d } t j | � | d <Wn t j k
r�d | d <n X| d
| d <| d | d
<| d | d <| d | d <| d | d <| d | d <| | d <| d | d <| d | d <| d | d <| | d <t � }
xB t D]: } t | t � r?| d | @ry|
j t | � qyq?q?W|
r�|
n | d | d <t � }
x0 t D]( } | d | @r�|
j t | � q�q�W|
r�|
n | d | d <y t | d | d! <Wn t k
r$| d | d! <n Xy t | d" | d# <Wn t k
r\| d" | d# <n Xy t! | d$ | d% <Wn t k
r�| d$ | d% <n Xy t" | d& | d' <Wn t k
r�| d& | d' <n X| S(( ur
Get information about a service on the system
Args:
name (str): The name of the service. This is not the display name. Use
``get_service_name`` to find the service name.
Returns:
dict: A dictionary containing information about the service.
CLI Example:
.. code-block:: bash
salt '*' service.info spooler
u! Failed to connect to the SCM: {0}u Failed To Open {0}: {1}u Failed to get descriptionNu u NT Service\{0}i u sidu Failed to get SIDi u
BinaryPathi u LoadOrderGroupi u TagIDi u Dependenciesi u ServiceAccounti u DisplayNameu Descriptionu ServiceSpecificExitCodeu Status_ServiceCodeu
CheckPointu Status_CheckPointu WaitHintu Status_WaitHintu StartTypeDelayedu ServiceTypeu ControlsAcceptedu
Win32ExitCodeu Status_ExitCodei u StartTypei u ErrorControlu CurrentStateu Status(# R- R. R t SC_MANAGER_CONNECTt
pywintypest errorR R t strerrort OpenServicet SERVICE_ENUMERATE_DEPENDENTSt SERVICE_INTERROGATEt SERVICE_QUERY_CONFIGt SERVICE_QUERY_STATUSt QueryServiceConfigt QueryServiceStatusExt QueryServiceConfig2t SERVICE_CONFIG_DESCRIPTIONt& SERVICE_CONFIG_DELAYED_AUTO_START_INFOR3 R6 t
win32securityt LookupAccountNamet ConvertSidToStringSidt listt SERVICE_TYPEt
isinstancet intt appendt SERVICE_CONTROLSt SERVICE_ERRORSt KeyErrort SERVICE_START_TYPEt SERVICE_ERROR_CONTROLt
SERVICE_STATE( R* R4 t exct
handle_svct config_infot status_infot descriptiont
delayed_startR5 t sidt flagst bit( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_service.pyR T s�
iZ c C@ s� t | � r t | d d �n y t j | � WnY t j k
r� } | j d k rr t d j | | j � � � n t
j d j | � � n Xt d | d t
j
� t | � d d d
g � } | d d k S(
u�
Start the specified service.
.. warning::
You cannot start a disabled service in Windows. If the service is
disabled, it will be changed to ``Manual`` start.
Args:
name (str): The name of the service to start
timeout (int):
The time in seconds to wait for the service to start before
returning. Default is 90 seconds
.. versionadded:: 2017.7.9,2018.3.4
Returns:
bool: ``True`` if successful, otherwise ``False``. Also returns ``True``
if the service is already started
CLI Example:
.. code-block:: bash
salt '*' service.start <service name>
t
start_typeu Manuali u Failed To Start {0}: {1}u Service "{0}" is runningR R R u
Start Pendingu Stoppedu Statusu Running( t disabledt modifyt win32serviceutilt StartServiceR; R< t winerrorR R R= t logt debugR R
RN ( R* t timeoutRV t
srv_status( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_service.pyt start� s c C@ s� y t j | � WnY t j k
rl } | j d k rS t d j | | j � � � n t j d j | � � n Xt
d | d t j � t | � d d d g � } | d d
k S( u
Stop the specified service
Args:
name (str): The name of the service to stop
timeout (int):
The time in seconds to wait for the service to stop before
returning. Default is 90 seconds
.. versionadded:: 2017.7.9,2018.3.4
Returns:
bool: ``True`` if successful, otherwise ``False``. Also returns ``True``
if the service is already stopped
CLI Example:
.. code-block:: bash
salt '*' service.stop <service name>
i& u Failed To Stop {0}: {1}u Service "{0}" is not runningR R R u Runningu Stop Pendingu Statusu Stopped(
Rb t StopServiceR; R< Rd R R R= Re Rf R R
RN ( R* Rg RV Rh ( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_service.pyt stop� s c C@ sB d | k r t � t � St d | d | � oA t d | d | � S( u�
Restart the named service. This issues a stop command followed by a start.
Args:
name: The name of the service to restart.
.. note::
If the name passed is ``salt-minion`` a scheduled task is
created and executed to restart the salt-minion service.
timeout (int):
The time in seconds to wait for the service to stop and start before
returning. Default is 90 seconds
.. note::
The timeout is cumulative meaning it is applied to the stop and
then to the start command. A timeout of 90 could take up to 180
seconds if the service is long in stopping and starting
.. versionadded:: 2017.7.9,2018.3.4
Returns:
bool: ``True`` if successful, otherwise ``False``
CLI Example:
.. code-block:: bash
salt '*' service.restart <service name>
u salt-minionR* Rg ( t create_win_salt_restart_taskt execute_salt_restart_taskRk Ri ( R* Rg ( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_service.pyt restart s
c C@ s\ t j j j d � } d } t d d d d d d t d d
d | d | d
d d d d d � S( u
Create a task in Windows task scheduler to enable restarting the salt-minion
Returns:
bool: ``True`` if successful, otherwise ``False``
CLI Example:
.. code-block:: bash
salt '*' service.create_win_salt_restart_task()
u cmduG /c ping -n 3 127.0.0.1 && net stop salt-minion && net start salt-minionu task.create_taskR* u restart-salt-miniont user_nameu Systemt forcet action_typeu ExecuteR t argumentst trigger_typeu Oncet
start_dateu
1975-01-01t
start_timeu 01:00( R R t patht whicht __salt__R) ( R R7 ( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_service.pyRl < s c C@ s t d d d � S( u�
Run the Windows Salt restart task
Returns:
bool: ``True`` if successful, otherwise ``False``
CLI Example:
.. code-block:: bash
salt '*' service.execute_salt_restart_task()
u task.runR* u restart-salt-minion( Rx ( ( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_service.pyRm X s
c O@ s� i } t � } t t j d | � � } | rB t j | | � } n | g } x( | D] } t | � d d k | | <qR W| r� | S| | S( u
Return the status for a service.
If the name contains globbing, a dict mapping service name to True/False
values is returned.
.. versionchanged:: 2018.3.0
The service name can now be a glob (e.g. ``salt*``)
Args:
name (str): The name of the service to check
Returns:
bool: True if running, False otherwise
dict: Maps service name to True if running, False otherwise
CLI Example:
.. code-block:: bash
salt '*' service.status <service name>
u \*|\?|\[.+\]u Statusu Runningu Stop Pending( u Runningu Stop Pending( R' t boolR t searcht fnmatcht filterR ( R* R7 t kwargst resultst all_servicest contains_globbingR# R$ ( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_service.pyt statush s
c C@ s t | � d S( u)
Return the SID for this windows service
Args:
name (str): The name of the service for which to return the SID
Returns:
str: A string representing the SID for the service
CLI Example:
.. code-block:: bash
salt '*' service.getsid <service name>
u sid( R ( R* ( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_service.pyt getsid� s c C@ s t j d d t j � } y# t j | | t j t j B� } Wn1 t j k
rn } t d j
| | j � � � n Xt j | � } t
� } | d k r� t | � } | d k r� d j
| | � } n | | d <n | d k r,| j � t k rt | j � } |
r)| t j B} q)qut d j
| � � � nI |
t k rL| d t j B} n) |
t k rl| d t j A} n t j } | t j k r�t � } x; t D]3 } t | t � r�| | @r�| j t | � q�q�W| r�| n | | d <n | d k r;| j � t k rt | j � } n t d j
| � � � t | | d <n t j } | d k r�| j � t k rut | j � } n t d j
| � � � t | | d
<n t j } | d k r�| | d <n | d k r�d } n | d k r�d | d <n | d k r| | d <n |
d k r |
| d <n | d k r6| | d <n t j | | | | | | d |
| | | � | d k r�t j | t j | � | | d <n | d k r�| d k r�| d d k s�| d k r�t j | t j | � | | d <q�d | d <n t j | � t j | � | S( u}
Modify a service's parameters. Changes will not be made for parameters that
are not passed.
.. versionadded:: 2016.11.0
Args:
name (str):
The name of the service. Can be found using the
``service.get_service_name`` function
bin_path (str):
The path to the service executable. Backslashes must be escaped, eg:
``C:\path\to\binary.exe``
exe_args (str):
Any arguments required by the service executable
display_name (str):
The name to display in the service manager
description (str):
The description to display for the service
service_type (str):
Specifies the service type. Default is ``own``. Valid options are as
follows:
- kernel: Driver service
- filesystem: File system driver service
- adapter: Adapter driver service (reserved)
- recognizer: Recognizer driver service (reserved)
- own (default): Service runs in its own process
- share: Service shares a process with one or more other services
start_type (str):
Specifies the service start type. Valid options are as follows:
- boot: Device driver that is loaded by the boot loader
- system: Device driver that is started during kernel initialization
- auto: Service that automatically starts
- manual: Service must be started manually
- disabled: Service cannot be started
start_delayed (bool):
Set the service to Auto(Delayed Start). Only valid if the start_type
is set to ``Auto``. If service_type is not passed, but the service
is already set to ``Auto``, then the flag will be set.
error_control (str):
The severity of the error, and action taken, if this service fails
to start. Valid options are as follows:
- normal: Error is logged and a message box is displayed
- severe: Error is logged and computer attempts a restart with the
last known good configuration
- critical: Error is logged, computer attempts to restart with the
last known good configuration, system halts on failure
- ignore: Error is logged and startup continues, no notification is
given to the user
load_order_group (str):
The name of the load order group to which this service belongs
dependencies (list):
A list of services or load ordering groups that must start before
this service
account_name (str):
The name of the account under which the service should run. For
``own`` type services this should be in the ``domain\username``
format. The following are examples of valid built-in service
accounts:
- NT Authority\LocalService
- NT Authority\NetworkService
- NT Authority\LocalSystem
- .\LocalSystem
account_password (str):
The password for the account name specified in ``account_name``. For
the above built-in accounts, this can be None. Otherwise a password
must be specified.
run_interactive (bool):
If this setting is True, the service will be allowed to interact
with the user. Not recommended for services that run with elevated
privileges.
Returns:
dict: a dictionary of changes made
CLI Example:
.. code-block:: bash
salt '*' service.modify spooler start_type=disabled
u Failed To Open {0}: {1}u {0} {1}u
BinaryPathu Invalid Service Type: {0}i u ServiceTypeu Invalid Start Type: {0}u StartTypeu Invalid Error Control: {0}u ErrorControlu ServiceAccountu LocalSystemu LocalServiceu NetworkServiceu u XXX-REDACTED-XXXu ServiceAccountPasswordu LoadOrderGroupu Dependenciesu DisplayNameu Descriptioni����i i u StartTypeDelayedu) start_delayed: Requires start_type "auto"u WarningN( u LocalSystemu LocalServiceu NetworkService( R- R. R R: R> t SERVICE_CHANGE_CONFIGRA R; R< R R R= RC R6 R R( RL t SERVICE_INTERACTIVE_PROCESSR) R t SERVICE_NO_CHANGERK RM RN RO RS RT t ChangeServiceConfigt ChangeServiceConfig2RF RG R3 ( R* t bin_patht exe_argst display_nameRZ t service_typeR_ t
start_delayedt
error_controlt load_order_groupt dependenciest account_namet account_passwordt run_interactiveR4 RW RV RX t changesR] R^ ( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_service.pyRa � s� u
(
c K@ s| t | d | d | �t | � } | j � d k r^ | d j � | j � k o] | d | k S| d j � | j � k Sd S( u�
Enable the named service to start at boot
Args:
name (str): The name of the service to enable.
start_type (str): Specifies the service start type. Valid options are as
follows:
- boot: Device driver that is loaded by the boot loader
- system: Device driver that is started during kernel initialization
- auto: Service that automatically starts
- manual: Service must be started manually
- disabled: Service cannot be started
start_delayed (bool): Set the service to Auto(Delayed Start). Only valid
if the start_type is set to ``Auto``. If service_type is not passed,
but the service is already set to ``Auto``, then the flag will be
set.
Returns:
bool: ``True`` if successful, ``False`` otherwise
CLI Example:
.. code-block:: bash
salt '*' service.enable <service name>
R_ R� u autou StartTypeu StartTypeDelayedN( Ra R R( ( R* R_ R� R} t svcstat( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_service.pyt enable� s
*c K@ s$ t | d d �t | � d d k S( u
Disable the named service to start at boot
Args:
name (str): The name of the service to disable
Returns:
bool: ``True`` if disabled, ``False`` otherwise
CLI Example:
.. code-block:: bash
salt '*' service.disable <service name>
R_ u Disabledu StartType( Ra R ( R* R} ( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_service.pyt disable� s c K@ s t | � d d k S( u$
Check to see if the named service is enabled to start on boot
Args:
name (str): The name of the service to check
Returns:
bool: True if the service is set to start
CLI Example:
.. code-block:: bash
salt '*' service.enabled <service name>
u StartTypeu Auto( R ( R* R} ( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_service.pyt enabled� s c C@ s t | � S( u"
Check to see if the named service is disabled to start on boot
Args:
name (str): The name of the service to check
Returns:
bool: True if the service is disabled
CLI Example:
.. code-block:: bash
salt '*' service.disabled <service name>
( R� ( R* ( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_service.pyR` � s u
.\LocalSystemc K@ s1 | d k r | } n | t � k r< t d j | � � � n t | � } | d k ri d j | | � } n | j � t k r� t | j � } |
r� | t j B} q� n t d j | � � � | j � t k r� t | j � } n t d j | � � � | j � t
k rt
| j � } n t d j | � � � | rQ| d k rQt d � � qQn | d k rfd } n t j d d t j � } t j
| | | t j | | | | | d |
| | �
} | d k r�t j | t j | � n | d k r
| d k r
t j | t j | � q
n t j | � t j | � t | � S( u�
Create the named service.
.. versionadded:: 2015.8.0
Args:
name (str):
Specifies the service name. This is not the display_name
bin_path (str):
Specifies the path to the service binary file. Backslashes must be
escaped, eg: ``C:\path\to\binary.exe``
exe_args (str):
Any additional arguments required by the service binary.
display_name (str):
The name to be displayed in the service manager. If not passed, the
``name`` will be used
description (str):
A description of the service
service_type (str):
Specifies the service type. Default is ``own``. Valid options are as
follows:
- kernel: Driver service
- filesystem: File system driver service
- adapter: Adapter driver service (reserved)
- recognizer: Recognizer driver service (reserved)
- own (default): Service runs in its own process
- share: Service shares a process with one or more other services
start_type (str):
Specifies the service start type. Valid options are as follows:
- boot: Device driver that is loaded by the boot loader
- system: Device driver that is started during kernel initialization
- auto: Service that automatically starts
- manual (default): Service must be started manually
- disabled: Service cannot be started
start_delayed (bool):
Set the service to Auto(Delayed Start). Only valid if the start_type
is set to ``Auto``. If service_type is not passed, but the service
is already set to ``Auto``, then the flag will be set. Default is
``False``
error_control (str):
The severity of the error, and action taken, if this service fails
to start. Valid options are as follows:
- normal (normal): Error is logged and a message box is displayed
- severe: Error is logged and computer attempts a restart with the
last known good configuration
- critical: Error is logged, computer attempts to restart with the
last known good configuration, system halts on failure
- ignore: Error is logged and startup continues, no notification is
given to the user
load_order_group (str):
The name of the load order group to which this service belongs
dependencies (list):
A list of services or load ordering groups that must start before
this service
account_name (str):
The name of the account under which the service should run. For
``own`` type services this should be in the ``domain\username``
format. The following are examples of valid built-in service
accounts:
- NT Authority\LocalService
- NT Authority\NetworkService
- NT Authority\LocalSystem
- .\LocalSystem
account_password (str):
The password for the account name specified in ``account_name``. For
the above built-in accounts, this can be None. Otherwise a password
must be specified.
run_interactive (bool):
If this setting is True, the service will be allowed to interact
with the user. Not recommended for services that run with elevated
privileges.
Returns:
dict: A dictionary containing information about the new service
CLI Example:
.. code-block:: bash
salt '*' service.create <service name> <path to exe> display_name='<display name>'
u Service Already Exists: {0}u {0} {1}u Invalid Service Type: {0}u Invalid Start Type: {0}u Invalid Error Control: {0}i u; Invalid Parameter: start_delayed requires start_type "auto"u LocalSystemu
.\LocalSystemu LocalServiceu .\LocalServiceu NetworkServiceu .\NetworkServiceu i N( u LocalSystemu
.\LocalSystemu LocalServiceu .\LocalServiceu NetworkServiceu .\NetworkService( R R' R R R R( RL R- R� RS RT R. t SC_MANAGER_ALL_ACCESSt
CreateServicet SERVICE_ALL_ACCESSR� RF RG R3 R ( R* R� R� R� RZ R� R_ R� R� R� R� R� R� R� R} R4 RW ( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_service.pyt create� sp r
c C@ sj t j d d t j � } y t j | | t j � } Wng t j k
r� } t j | � | j d k r� t
d j | | j � � � n t
j d j | � � t SXzI y t j | � Wn1 t j k
r� } t
d j | | j � � � n XWd t
j d � t j | � t j | � Xt j � t | � } x2 | t � k r\t j � | k r\t j d � q+W| t � k S( uf
Delete the named service
Args:
name (str): The name of the service to delete
timeout (int):
The time in seconds to wait for the service to be deleted before
returning. This is necessary because a service must be stopped
before it can be deleted. Default is 90 seconds
.. versionadded:: 2017.7.9,2018.3.4
Returns:
bool: ``True`` if successful, otherwise ``False``. Also returns ``True``
if the service is not present
CLI Example:
.. code-block:: bash
salt '*' service.delete <service name>
i$ u Failed to open {0}. {1}u Service "{0}" is not presentu Failed to delete {0}. {1}Nu Cleaning upi ( R- R. R R: R> R� R; R< R3 Rd R R R= Re Rf R) t
DeleteServiceR
RN R' R ( R* Rg R4 RW RV R ( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_service.pyt delete� s2
$(: t __doc__t
__future__R R R R{ t loggingR R
t salt.utils.platformR t salt.utils.patht salt.exceptionsR RH R- Rb R; R) R t ImportErrorR t getLoggert __name__Re R
RL RP RU RQ RS RT R R R R% R& R+ R, R R' R9 R Ri Rk Rn Rl Rm R� R� R Ra R� R� R� R` R� R� ( ( ( s< /usr/lib/python2.7/site-packages/salt/modules/win_service.pyt <module> s�
- & m . & ' % �' �
Mini Shell