Current File : //usr/lib/python2.7/site-packages/salt/modules/win_servermanager.pyc
�
���^c @@ s
d Z d d l m Z m Z m Z d d l Z y d d l m Z Wn! e k
re d d l
m Z n Xd d l Z d d l
Z d d l Z d d l Z d d l m Z e j e � Z d Z d � Z d d � Z d � Z d
� Z e e d d d � Z e e d � Z d S(
u/
Manage Windows features via the ServerManager powershell module. Can list
available and installed roles/features. Can install and remove roles/features.
:maintainer: Shane Lee <slee@saltstack.com>
:platform: Windows Server 2008R2 or greater
:depends: PowerShell module ``ServerManager``
i ( t absolute_importt unicode_literalst print_functionN( t quote( t CommandExecutionErroru win_servermanagerc C@ se t j j j � s t St j j j t d d � d k rB t d f St j j j d � sa t d f St
S( u8
Load only on windows with servermanager module
u osversionu 6.1.7600i����u� Failed to load win_servermanager module: Requires Remote Server Administration Tools which is only available on Windows 2008 R2 and later.u
ServerManageru� Failed to load win_servermanager module: ServerManager module not available. May need to install Remote Server Administration Tools.( t saltt utilst platformt
is_windowst Falset versionst version_cmpt
__grains__t
powershellt
module_existst __virtualname__( ( ( sB /usr/lib/python2.7/site-packages/salt/modules/win_servermanager.pyt __virtual__ s "
c C@ sT d j | � } d | j � k r3 d j | � } n t j d | � t d | d d d | �} d | k ru | d =n | j d
d � r� | d
j � d } t | d
| �� n d | k s� | d d k r� t d j | � d
| �� n | d d k rd | d <n y# t j j
j | d d t �} Wn# t
k
rOt d d
| �� n X| S( u}
Execute the desired powershell command and ensure that it returns data
in JSON format and load that into python
u Import-Module ServerManager; {0}u convertto-jsonu {0} | ConvertTo-Jsonu PowerShell: %su cmd.run_allt shellu
powershellt cwdu pidu stderru i t infou retcodeu Issue executing PowerShell {0}u stdoutu {}t strictu No JSON results from PowerShell( t formatt lowert logt debugt __salt__t gett
splitlinesR R R t jsont loadsR t
ValueError( t cmdR t rett error( ( sB /usr/lib/python2.7/site-packages/salt/modules/win_servermanager.pyt _pshell_json4 s*
#
c C@ s d } t d | d d �S( u
List available features to install
Returns:
str: A list of available features as returned by the
``Get-WindowsFeature`` PowerShell command
CLI Example:
.. code-block:: bash
salt '*' win_servermanager.list_available
um Import-Module ServerManager; Get-WindowsFeature -ErrorAction SilentlyContinue -WarningAction SilentlyContinueu cmd.shellR u
powershell( R ( R ( ( sB /usr/lib/python2.7/site-packages/salt/modules/win_servermanager.pyt list_availableW s c C@ sL d } t | � } i } x- | D]% } | d r | d | | d <q q W| S( u�
List installed features. Supported on Windows Server 2008 and Windows 8 and
newer.
Returns:
dict: A dictionary of installed features
CLI Example:
.. code-block:: bash
salt '*' win_servermanager.list_installed
ut Get-WindowsFeature -ErrorAction SilentlyContinue -WarningAction SilentlyContinue | Select DisplayName,Name,Installedu Installedu DisplayNameu Name( R" ( R t featuresR t entry( ( sB /usr/lib/python2.7/site-packages/salt/modules/win_servermanager.pyt list_installedl s
c C@ s t | t � r! d j | � } n d } d } t j j j t d d � d k r^ d } d } n d j | t | � | | r d
n d | d k r� d n d j | � � } t | � } | d k r� t | � } n | d r�i | d
d
6t
d 6t
d 6i d 6| d d 6}
xr | d D]f } i | d d 6| d d 6| d d 6| d d 6| d d 6|
d | d <| d rt |
d <qqWx? | j d � D]. } | |
d k r�i d d 6|
d | <q�q�W| d k rvx� | d D]� } | |
d k r�i d d 6| d | d d 6| d | d d 6| d | d d 6| d | d d 6|
d | <| d | d rot |
d <qoq�q�Wn | r�|
d r�t d d t � r�t |
d <q�q�n |
Si | d
d
6i d 6t
d 6t
d 6| d d 6}
x, | j d � D] } i d d 6|
d | <q�W|
Sd S( u
Install a feature
.. note::
Some features require reboot after un/installation, if so until the
server is restarted other features can not be installed!
.. note::
Some features take a long time to complete un/installation, set -t with
a long timeout
Args:
feature (str, list):
The name of the feature(s) to install. This can be a single feature,
a string of features in a comma delimited list (no spaces), or a
list of features.
.. versionadded:: 2018.3.0
Added the ability to pass a list of features to be installed.
recurse (Options[bool]):
Install all sub-features. Default is False
restart (Optional[bool]):
Restarts the computer when installation is complete, if required by
the role/feature installed. Will also trigger a reboot if an item
in ``exclude`` requires a reboot to be properly removed. Default is
False
source (Optional[str]):
Path to the source files if missing from the target system. None
means that the system will use windows update services to find the
required files. Default is None
exclude (Optional[str]):
The name of the feature to exclude when installing the named
feature. This can be a single feature, a string of features in a
comma-delimited list (no spaces), or a list of features.
.. warning::
As there is no exclude option for the ``Add-WindowsFeature``
or ``Install-WindowsFeature`` PowerShell commands the features
named in ``exclude`` will be installed with other sub-features
and will then be removed. **If the feature named in ``exclude``
is not a sub-feature of one of the installed items it will still
be removed.**
Returns:
dict: A dictionary containing the results of the install
CLI Example:
.. code-block:: bash
# Install the Telnet Client passing a single string
salt '*' win_servermanager.install Telnet-Client
# Install the TFTP Client and the SNMP Service passing a comma-delimited
# string. Install all sub-features
salt '*' win_servermanager.install TFTP-Client,SNMP-Service recurse=True
# Install the TFTP Client from d:\side-by-side
salt '*' win_servermanager.install TFTP-Client source=d:\\side-by-side
# Install the XPS Viewer, SNMP Service, and Remote Access passing a
# list. Install all sub-features, but exclude the Web Server
salt '*' win_servermanager.install "['XPS-Viewer', 'SNMP-Service', 'RemoteAccess']" True recurse=True exclude="Web-Server"
u ,u Add-WindowsFeatureu u osversionu 6.2i u Install-WindowsFeatureu -IncludeManagementToolsu9 {0} -Name {1} {2} {3} {4} -WarningAction SilentlyContinueu -IncludeAllSubFeatureu -Source {0}u
FeatureResultu ExitCodeu
RestartNeededu Restartedu Featuresu Successu DisplayNameu Messageu
SkipReasonu Nameu Already installedu$ Removed after installation (exclude)u system.restartt
in_secondsN( t
isinstancet listt joinR R R
R R R t
_cmd_quotet NoneR" t removeR t Truet splitR ( t featuret recurset restartt sourcet excludet commandt management_toolsR t outt removedR t item( ( sB /usr/lib/python2.7/site-packages/salt/modules/win_servermanager.pyt install� sp G" $
c C@ s7 t | t � r! d j | � } n d } d } d } t j j j t d d � d k rs d } d } | rs d } qs n d
j | t | � | | | r� d n d � } y t
| � } Wn= t k
r� } d | j k r� t d
d | j
�� n � n X| d r�i | d d 6t d 6t d 6i d 6| d d 6} x[ | d D]O }
i |
d d 6|
d d 6|
d d 6|
d d 6|
d d 6| d |
d <q6Wx? | j d � D]. }
|
| d k r�i d d 6| d |
<q�q�W| Si | d d 6i d 6t d 6t d 6| d d 6} x, | j d � D] }
i d d 6| d |
<qW| Sd S( u
Remove an installed feature
.. note::
Some features require a reboot after installation/uninstallation. If
one of these features are modified, then other features cannot be
installed until the server is restarted. Additionally, some features
take a while to complete installation/uninstallation, so it is a good
idea to use the ``-t`` option to set a longer timeout.
Args:
feature (str, list):
The name of the feature(s) to remove. This can be a single feature,
a string of features in a comma delimited list (no spaces), or a
list of features.
.. versionadded:: 2018.3.0
Added the ability to pass a list of features to be removed.
remove_payload (Optional[bool]):
True will cause the feature to be removed from the side-by-side
store (``%SystemDrive%:\Windows\WinSxS``). Default is False
restart (Optional[bool]):
Restarts the computer when uninstall is complete, if required by the
role/feature removed. Default is False
Returns:
dict: A dictionary containing the results of the uninstall
CLI Example:
.. code-block:: bash
salt -t 600 '*' win_servermanager.remove Telnet-Client
u ,u Remove-WindowsFeatureu u osversionu 6.2i u Uninstall-WindowsFeatureu -IncludeManagementToolsu -Removeu9 {0} -Name {1} {2} {3} {4} -WarningAction SilentlyContinueu -Restartu ArgumentNotValidu Invalid Feature NameR u
FeatureResultu ExitCodeu
RestartNeededu Restartedu Featuresu Successu DisplayNameu Messageu
SkipReasonu Nameu
Not installedN( R( R) R* R R R
R R R R+ R" R t messageR R R/ ( R0 t remove_payloadR2 R5 R6 t _remove_payloadR R7 t excR R9 ( ( sB /usr/lib/python2.7/site-packages/salt/modules/win_servermanager.pyR- - sZ '"
( t __doc__t
__future__R R R t loggingt shlexR R+ t ImportErrort pipest salt.utils.jsonR t salt.utils.platformt salt.utils.powershellt salt.utils.versionst salt.exceptionsR t getLoggert __name__R R R R, R" R# R& R R: R- ( ( ( sB /usr/lib/python2.7/site-packages/salt/modules/win_servermanager.pyt <module> s&
# �
Mini Shell