File manager - Edit - /opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/__pycache__/win_dism.cpython-310.pyc
Back
o ;j[X � @ s� d Z ddlZddlZddlZddlZddlZddlmZ e� e �Z dZ z7ej j�� s,e�ej�ej�ej�d�d��rGej�ej�d�d�Zn ej�ej�d�d�Zej�ed�ZW n eyj e �d � dZY nw d d � Zd/d d �Z d0dd�Zd1dd�Z d/dd�Z d/dd�Z d/dd�Z d2dd�Z d3dd �Z!d4d d �Z"d/d d �Z#d/d!d"�Z$ d5d#d$�Z%d1d%d&�Z&d/d'd(�Z'd1d)d*�Z(d/d+d,�Z)d/d-d.�Z*dS )6z� Install features/packages for Windows using DISM, which is useful for minions not running server versions of Windows. Some functions are only available on Windows 10. � N)�CommandExecutionErrorZdismZ SystemRootZ SysNativeZSystem32zdism.exez win_dism: Non-Windows systemc C s t jj�� sdS tS )z Only works on Windows )Fz!Only available on Windows systems)�salt�utils�platform� is_windows�__virtualname__� r r �I/opt/saltstack/salt/lib/python3.10/site-packages/salt/modules/win_dism.py� __virtual__( s r c C sX t d|r d|� �ndd|� �g}td |�}| � d|� d�}t�||tj�}|�� |S )N�/English�/Image:�/Onlinez/Get-�cmd.runz : (.*)\r\n.*State : z\r\n)�bin_dism�__salt__�re�findall� MULTILINE�sort)� type_regex� plural_type� install_value�image�cmd�out�pattern� capabilitiesr r r �_get_components2 s � r Fc C s� t jj�td d�dkrtd�td ���td|r d|� �nddd | � �g}|r0|�d |� �� |r7|�d � |s>|�d � t d |�S )a� Install a capability Args: capability (str): The capability to install source (:obj:`str`, optional): The optional source of the capability. Default is set by group policy and can be Windows Update. Default is ``None``. limit_access (:obj:`bool`, optional): Prevent DISM from contacting Windows Update for the source package. Default is ``False``. image (:obj:`str`, optional): The path to the root directory of an offline Windows image. If ``None`` is passed, the running operating system is targeted. Default is ``None``. restart (:obj:`bool`, optional): Reboot the machine if required by the install. Default is ``False``. Raises: NotImplementedError: For all versions of Windows that are not Windows 10 and later. Server editions of Windows use ServerManager instead. Returns: dict: A dictionary containing the results of the command CLI Example: .. code-block:: bash salt '*' dism.add_capability 'Tools.Graphics.DirectX~~~~0.0.1.0' � osversion�10���zD`install_capability` is not available on this version of Windows: {}�/Quietr r z/Add-Capability�/CapabilityName:�/Source:� /LimitAccess� /NoRestart� cmd.run_all� r r �versions� version_cmp� __grains__�NotImplementedError�formatr �appendr )� capability�source� limit_accessr �restartr r r r �add_capability@ s$ ) �� r2 c C sf t jj�td d�dkrtd�td ���td|r d|� �nddd | � �g}|s-|�d � t d |�S ) a5 Uninstall a capability Args: capability(str): The capability to be removed image (:obj:`str`, optional): The path to the root directory of an offline Windows image. If ``None`` is passed, the running operating system is targeted. Default is ``None``. restart (:obj:`bool`, optional): Reboot the machine if required by the install. Default is ``False``. Raises: NotImplementedError: For all versions of Windows that are not Windows 10 and later. Server editions of Windows use ServerManager instead. Returns: dict: A dictionary containing the results of the command CLI Example: .. code-block:: bash salt '*' dism.remove_capability 'Tools.Graphics.DirectX~~~~0.0.1.0' r r r zF`uninstall_capability` is not available on this version of Windows: {}r! r r z/Remove-Capabilityr" r% r& r' )r. r r1 r r r r �remove_capability� s �� r3 c C sp t jj�td d�dkrtd�td ���td| r d| � �nddg}td |�}d }t � ||t j �}|� � |S ) aC List all capabilities on the system Args: image (:obj:`str`, optional): The path to the root directory of an offline Windows image. If ``None`` is passed, the running operating system is targeted. Default is ``None``. Raises: NotImplementedError: For all versions of Windows that are not Windows 10 and later. Server editions of Windows use ServerManager instead. Returns: list: A list of capabilities CLI Example: .. code-block:: bash salt '*' dism.get_capabilities r r r �H`installed_capabilities` is not available on this version of Windows: {}r r r z/Get-Capabilitiesr z Capability Identity : (.*)\r\n) r r r( r) r* r+ r, r r r r r r )r r r r r r r r �get_capabilities� s �� r5 c C �: t jj�td d�dkrtd�td ���tddd| d�S ) a] List the capabilities installed on the system Args: image (:obj:`str`, optional): The path to the root directory of an offline Windows image. If ``None`` is passed, the running operating system is targeted. Default is ``None``. Raises: NotImplementedError: For all versions of Windows that are not Windows 10 and later. Server editions of Windows use ServerManager instead. Returns: list: A list of installed capabilities CLI Example: .. code-block:: bash salt '*' dism.installed_capabilities r r r r4 �Capability Identity� Capabilities� Installed�r r r r �r r r( r) r* r+ r, r �r r r r �installed_capabilities� � ��r= c C r6 ) a] List the capabilities available on the system Args: image (:obj:`str`, optional): The path to the root directory of an offline Windows image. If ``None`` is passed, the running operating system is targeted. Default is ``None``. Raises: NotImplementedError: For all versions of Windows that are not Windows 10 and later. Server editions of Windows use ServerManager instead. Returns: list: A list of available capabilities CLI Example: .. code-block:: bash salt '*' dism.installed_capabilities r r r r4 r7 r8 z Not Presentr: r; r< r r r �available_capabilities r> r? c C s� t d|r d|� �nddd| � �g}|r|�d|� �� |r%|�d|� �� |r,|�d� |r3|�d � |s:|�d � td |�S ) a� Install a feature using DISM Args: feature (str): The feature to install package (:obj:`str`, optional): The parent package for the feature. You do not have to specify the package if it is the Windows Foundation Package. Otherwise, use package to specify the parent package of the feature. Default is ``None``. source (:obj:`str`, optional): The optional source of the capability. Default is set by group policy and can be Windows Update. Default is ``None``. limit_access (:obj:`bool`, optional): Prevent DISM from contacting Windows Update for the source package. Default is ``False``. enable_parent (:obj:`bool`, optional): ``True`` will enable all parent features of the specified feature. Default is ``False``. image (:obj:`str`, optional): The path to the root directory of an offline Windows image. If ``None`` is passed, the running operating system is targeted. Default is ``None``. restart (:obj:`bool`, optional): Reboot the machine if required by the install. Default is ``False``. Returns: dict: A dictionary containing the results of the command CLI Example: .. code-block:: bash salt '*' dism.add_feature 'NetFx3' r! r r z/Enable-Feature� /FeatureName:� /PackageName:r# r$ z/Allr% r& �r r- r )�feature�packager/ r0 Z enable_parentr r1 r r r r � add_feature* s" 6� rE c C sJ t d|r d|� �nddd| � �g}|r|�d� |s |�d� td |�S ) a# Disables the feature. Args: feature (str): The feature to uninstall. remove_payload (:obj:`bool`, optional): Remove the feature's payload. Must supply source when enabling in the future. Default is ``False``. image (:obj:`str`, optional): The path to the root directory of an offline Windows image. If ``None`` is passed, the running operating system is targeted. Default is ``None``. restart (:obj:`bool`, optional): Reboot the machine if required by the install. Default is ``False``. Returns: dict: A dictionary containing the results of the command CLI Example: .. code-block:: bash salt '*' dism.remove_feature 'NetFx3' r! r r z/Disable-Featurer@ z/Remover% r& rB )rC Zremove_payloadr r1 r r r r �remove_featuret s � rF c C st t d|r d|� �nddg}| r$d| v r |�d| � �� n|�d| � �� td |�}d }t�||tj�}|�� |S ) a� List features on the system or in a package Args: package (:obj:`str`, optional): The full path to the package. Can be either a .cab file or a folder. Should point to the original source of the package, not to where the file is installed. You cannot use this command to get package information for .msu files This can also be the name of a package as listed in ``dism.installed_packages`` Default is ``None``. image (:obj:`str`, optional): The path to the root directory of an offline Windows image. If ``None`` is passed, the running operating system is targeted. Default is ``None``. Returns: list: A list of features CLI Example: .. code-block:: bash # Return all features on the system salt '*' dism.get_features # Return all features in package.cab salt '*' dism.get_features 'C:\packages\package.cab' # Return all features in the calc package salt '*' dism.get_features 'Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0' r r r z /Get-Features�~rA � /PackagePath:r zFeature Name : (.*)\r\n)r r- r r r r r )rD r r r r Zfeaturesr r r � get_features� s '� rI c C � t ddd| d�S )a� List the features installed on the system Args: image (:obj:`str`, optional): The path to the root directory of an offline Windows image. If ``None`` is passed, the running operating system is targeted. Default is ``None``. Returns: list: A list of installed features CLI Example: .. code-block:: bash salt '*' dism.installed_features � Feature Name�FeaturesZEnabledr: �r r< r r r �installed_features� � �rN c C rJ )a� List the features available on the system Args: image (:obj:`str`, optional): The path to the root directory of an offline Windows image. If ``None`` is passed, the running operating system is targeted. Default is ``None``. Returns: list: A list of available features CLI Example: .. code-block:: bash salt '*' dism.available_features rK rL ZDisabledr: rM r< r r r �available_features� rO rP c C sX t d|r d|� �nddd| � �g}|r|�d� |r |�d� |s&|�d� td |�S ) a� Install a package using DISM Args: package (str): The package to install. Can be a .cab file, a .msu file, or a folder. .. note:: An `.msu` package is supported only when the target image is offline, either mounted or applied. ignore_check (:obj:`bool`, optional): Skip installation of the package if the applicability checks fail. Default is ``False``. prevent_pending (:obj:`bool`, optional): Skip the installation of the package if there are pending online actions. Default is ``False``. image (:obj:`str`, optional): The path to the root directory of an offline Windows image. If ``None`` is passed, the running operating system is targeted. Default is ``None``. restart (:obj:`bool`, optional): Reboot the machine if required by the install. Default is ``False``. Returns: dict: A dictionary containing the results of the command CLI Example: .. code-block:: bash salt '*' dism.add_package 'C:\Packages\package.cab' r! r r z /Add-PackagerH z /IgnoreCheckz/PreventPendingr% r& rB )rD Z ignore_checkZprevent_pendingr r1 r r r r � add_package s +� rQ c C s^ t d|r d|� �nddg}|s|�d� d| v r!|�d| � �� n|�d| � �� td |�S ) aN Uninstall a package Args: package (str): The full path to the package. Can be either a .cab file or a folder. Should point to the original source of the package, not to where the file is installed. This can also be the name of a package as listed in ``dism.installed_packages`` image (:obj:`str`, optional): The path to the root directory of an offline Windows image. If ``None`` is passed, the running operating system is targeted. Default is ``None``. restart (:obj:`bool`, optional): Reboot the machine if required by the uninstall. Default is ``False``. Returns: dict: A dictionary containing the results of the command CLI Example: .. code-block:: bash # Remove the Calc Package salt '*' dism.remove_package 'Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0' # Remove the package.cab (does not remove C:\packages\package.cab) salt '*' dism.remove_package 'C:\packages\package.cab' r! r r z/Remove-Packager% rG rA rH r& rB )rD r r1 r r r r �remove_packageS s #� rR c C sP t |d�}| �� �d�r| �� nd| � �}|D ]}d|� d�|v r%| S qdS )a' Get the actual package name on the system based on the KB name. .. versionadded:: 3006.0 Args: kb (str): The name of the KB to remove. Can also be just the KB number. image (:obj:`str`, optional): The path to the root directory of an offline Windows image. If ``None`` is passed, the running operating system is targeted. Default is ``None``. Returns: str: The name of the package found on the system None: If the package is not installed on the system CLI Example: .. code-block:: bash # Get the package name for KB1231231 salt '*' dism.get_kb_package_name KB1231231 # Get the package name for KB1231231 using just the number salt '*' dism.get_kb_package_name 1231231 r< �kbZKB�_rG N)�installed_packages�lower� startswith�upper)rS r Zpackages�searchrD r r r �get_kb_package_name� s �rZ c C s@ t | |d�}|du r| � d�}t|��t�d|� t|||d�S )a� Remove a package by passing a KB number. This searches the installed packages to get the full package name of the KB. It then calls the ``dism.remove_package`` function to remove the package. .. versionadded:: 3006.0 Args: kb (str): The name of the KB to remove. Can also be just the KB number. image (:obj:`str`, optional): The path to the root directory of an offline Windows image. If ``None`` is passed, the running operating system is targeted. Default is ``None``. restart (:obj:`bool`, optional): Reboot the machine if required by the uninstall. Default is ``False``. Returns: dict: A dictionary containing the results of the command CLI Example: .. code-block:: bash # Remove the KB5007575 just passing the number salt '*' dism.remove_kb 5007575 # Remove the KB5007575 just passing the full name salt '*' dism.remove_kb KB5007575 )rS r Nz not installedz Found: %s)rD r r1 )rZ r �log�debugrR )rS r r1 �pkg_name�msgr r r � remove_kb� s " r_ c C rJ )a� List the packages installed on the system Args: image (:obj:`str`, optional): The path to the root directory of an offline Windows image. If ``None`` is passed, the running operating system is targeted. Default is ``None``. Returns: list: A list of installed packages CLI Example: .. code-block:: bash salt '*' dism.installed_packages zPackage IdentityZPackagesr9 r: rM r< r r r rU � rO rU c C s� t d|r d|� �nddg}d| v r|�d| � �� n|�d| � �� td |�}|d d krVt� }t|d ��� D ]}d |v rS|�d �}t|�d k rKq9|d ||d < q9|S |}|S )a� Display information about a package Args: package (str): The full path to the package. Can be either a .cab file or a folder. Should point to the original source of the package, not to where the file is installed. You cannot use this command to get package information for .msu files image (:obj:`str`, optional): The path to the root directory of an offline Windows image. If ``None`` is passed, the running operating system is targeted. Default is ``None``. Returns: dict: A dictionary containing the results of the command CLI Example: .. code-block:: bash salt '*' dism. package_info 'C:\packages\package.cab' r r r z/Get-PackageInforG rA rH r& �retcoder �stdoutz : � � )r r- r �dict�str� splitlines�split�len)rD r r r �ret�line�infor r r � package_info� s* � ��rl )N)NFNF)NF)NNFFNF)FNF)NN)FFNF)+�__doc__�logging�osr Zsalt.utils.platformr Zsalt.utils.versionsZsalt.exceptionsr � getLogger�__name__r[ r r r r �OSError�path�exists�join�environ�getZbin_pathr Ztracer r r2 r3 r5 r= r? rE rF rI rN rP rQ rR rZ r_ rU rl r r r r �<module> s\ � � A 2 - %' � J / < � < 4 % *
| ver. 1.4 |
Github
|
.
| PHP 8.2.30 | Generation time: 0 |
proxy
|
phpinfo
|
Settings