File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/__pycache__/win_servermanager.cpython-310.pyc
Back
o ;j;9 � @ s� d Z ddlZddlZddlZddlZddlZddlZddlm Z e� e �Z dZ dd� Zddd�Zd d � Zd d � Zddd�Zddd�ZdS )a/ 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`` � N)�CommandExecutionErrorZwin_servermanagerc C sB t jj�� sdS t jj�td d�dkrdS t jj�d�s dS t S )z8 Load only on windows with servermanager module )Fz?Module win_servermanager: module only works on Windows systems.� osversionz6.1.7600���)Fz�Failed to load win_servermanager module: Requires Remote Server Administration Tools which is only available on Windows 2008 R2 and later.Z ServerManager)Fz�Failed to load win_servermanager module: ServerManager module not available. May need to install Remote Server Administration Tools.) �salt�utils�platformZ is_windows�versions� version_cmp� __grains__� powershellZ module_exists�__virtualname__� r r �R/opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/win_servermanager.py� __virtual__ s r c C s� d| � �} d| � � vr| � d�} t�d| � td | d|d�}d|v r&|d= |�d d �r:|d �� d }t||d ��d |vsD|d d krMtd| � �|d ��|d d krWd|d< ztjj j |d dd�}W |S t yr td|d ��w )z} Execute the desired powershell command and ensure that it returns data in JSON format and load that into python z Import-Module ServerManager; zconvertto-jsonz | ConvertTo-JsonzPowerShell: %sz cmd.run_allr )�shell�cwd�pid�stderr� r ��info�retcodezIssue executing PowerShell �stdoutz{}F)�strictz No JSON results from PowerShell) �lower�log�debug�__salt__�get� splitlinesr r r �json�loads� ValueError)�cmdr �ret�errorr r r � _pshell_json5 s( � �r& c C s d} t d | dd�S )a 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 zmImport-Module ServerManager; Get-WindowsFeature -ErrorAction SilentlyContinue -WarningAction SilentlyContinuez cmd.shellr )r )r )r# r r r �list_availableV s �r' c C s6 d} t | �}i }|D ]}|d r|d ||d < q |S )z� 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 ztGet-WindowsFeature -ErrorAction SilentlyContinue -WarningAction SilentlyContinue | Select DisplayName,Name,InstalledZ Installed� DisplayName�Name)r& )r# Zfeaturesr$ �entryr r r �list_installedm s ��r+ Fc C s t | t�r d�| �} d}d}tjj�td d�dkr d}d}d �|t � | �||r*d nd|d u r1dnd |� ��}t |�}|d urCt |�} |d r�|d ddi |d d�} |d D ]"} | d | d | d | d | d d�| d | d < | d ryd| d< qW| � d�D ]} | | d vr�ddi| d | < q|d ur�| d D ]8} | | d v r�d| d | d | d | d | d | d | d | d d �| d | < | d | d r�d| d< q�|r�| d r�td dd �r�d| d < | S |d i dd|d d �} | � d�D ] } ddi| d | < q�| S )!ar 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 (:obj:`bool`, optional): Install all sub-features. Default is ``False``. restart (:obj:`bool`, optional): 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 (:obj:`str`, optional): 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 (:obj:`str`, optional): 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.** Default is ``None``. 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" �,zAdd-WindowsFeaturer r �6.2r zInstall-WindowsFeature�-IncludeManagementTools�4{} -Name {} {} {} {} -WarningAction SilentlyContinuez-IncludeAllSubFeatureNz-Source � FeatureResult�ExitCodeF�Success�r1 � RestartNeeded� Restarted�Featuresr2 r( �Messager4 � SkipReason�r( r7 r4 r8 r2 r6 r) TzAlready installedz$Removed after installation (exclude))r7 r( r4 r8 r2 z system.reboot)Z in_secondsr5 �r1 r6 r4 r5 r2 )� isinstance�list�joinr r r r r �format�shlex�quoter& �remove�splitr ) �featureZrecurse�restart�sourceZexclude�command�management_toolsr# �outZremovedr$ �itemr r r �install� s� N �� �� � � ��rJ c C sr t | t�r d�| �} d}d}d}tjj�td d�dkr$d}d}|r$d }d �|t � | �|||r1d nd�}zt |�}W n t yS } z d |j v rNt d |jd��� d}~ww |d r�|d ddi |d d�} |d D ]} | d | d | d | d | d d�| d | d < qh| �d�D ]} | | d vr�dd i| d | < q�| S |d i dd|d d �} | �d�D ] } dd i| d | < q�| S ) aQ 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 (:obj:`bool`, optional): True will cause the feature to be removed from the side-by-side store (``%SystemDrive%:\Windows\WinSxS``). Default is ``False``. restart (:obj:`bool`, optional): 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 r, zRemove-WindowsFeaturer r r- r zUninstall-WindowsFeaturer. z-Remover/ z-RestartZArgumentNotValidzInvalid Feature Namer Nr0 r1 Fr2 r3 r( r7 r4 r8 r9 r6 r) z Not installedr: )r; r< r= r r r r r r> r? r@ r& r �messager rB ) rC Zremove_payloadrD rF rG Z_remove_payloadr# rH �excr$ rI r r r rA = sj + � ��� � ��rA )N)FFNN)FF)�__doc__�loggingr? Zsalt.utils.jsonr Zsalt.utils.platformZsalt.utils.powershellZsalt.utils.versionsZsalt.exceptionsr � getLogger�__name__r r r r& r' r+ rJ rA r r r r �<module> s" ! 3
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings