Current File : //usr/lib/python2.7/site-packages/salt/modules/win_dism.pyc
�
���^c @@ sA 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 m Z e j
e � Z d Z y� e j j j � s� e � n e j j e j j e j j d � d � � r� e j j e j j d � d � Z n! e j j e j j d � d � Z e j j e d � Z Wn$ e k
rOe j d
� d Z n Xd � Z d d � Z d e d e d
� Z! d e d � Z" d d � Z# d d � Z$ d d � Z% d d e e d e d � Z& e d e d � Z' d d d � Z( d d � Z) d d � Z* e e d e d � Z+ d e d � Z, d d � Z- d d � Z. d S( u�
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.
i ( t absolute_importt unicode_literalst print_functionN( t sixu dismu
SystemRootu SysNativeu System32u dism.exeu win_dism: Non-Windows systemc C@ s t j j j � s t d f St S( u
Only work on Windows
u! Only available on Windows systems( t saltt utilst platformt
is_windowst Falset __virtualname__( ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_dism.pyt __virtual__/ s
c C@ sx t d | r d j | � n d d j | � g } t d | � } d j | | � } t j | | t j � } | j � | S( Nu /Englishu
/Image:{0}u /Onlineu /Get-{0}u cmd.runu {0} : (.*)\r\n.*State : {1}\r\n( t bin_dismt formatt __salt__t ret findallt MULTILINEt sort( t
type_regext plural_typet
install_valuet imaget cmdt outt patternt capabilities( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_dism.pyt _get_components9 s
c C@ s� t j j j t d d � d k r> t d j t d � � � n t d | rY d j | � n d d d j | � g } | r� | j d
j | � � n | r� | j d � n | s� | j d � n t d
| � S( u�
Install a capability
Args:
capability (str): The capability to install
source (Optional[str]): The optional source of the capability. Default
is set by group policy and can be Windows Update.
limit_access (Optional[bool]): Prevent DISM from contacting Windows
Update for the source package
image (Optional[str]): 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 (Optional[bool]): Reboot the machine if required by the install
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
u osversionu 10i����uE `install_capability` is not available on this version of Windows: {0}u /Quietu
/Image:{0}u /Onlineu /Add-Capabilityu /CapabilityName:{0}u /Source:{0}u /LimitAccessu
/NoRestartu cmd.run_all(
R R t versionst version_cmpt
__grains__t NotImplementedErrorR R t appendR
( t
capabilityt sourcet limit_accessR t restartR ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_dism.pyt add_capabilityF s "c C@ s� t j j j t d d � d k r> t d j t d � � � n t d | rY d j | � n d d d j | � g } | s� | j d
� n t d | � S( u�
Uninstall a capability
Args:
capability(str): The capability to be removed
image (Optional[str]): 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 (Optional[bool]): Reboot the machine if required by the install
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
u osversionu 10i����uG `uninstall_capability` is not available on this version of Windows: {0}u /Quietu
/Image:{0}u /Onlineu /Remove-Capabilityu /CapabilityName:{0}u
/NoRestartu cmd.run_all(
R R R R R R R R R R
( R R R# R ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_dism.pyt remove_capability{ s "c C@ s� t j j j t d d � d k r> t d j t d � � � n t d | rY d j | � n d d g } t d | � } d
} t j
| | t j � } | j � | S( u)
List all capabilities on the system
Args:
image (Optional[str]): 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
u osversionu 10i����uI `installed_capabilities` is not available on this version of Windows: {0}u /Englishu
/Image:{0}u /Onlineu /Get-Capabilitiesu cmd.runu Capability Identity : (.*)\r\n(
R R R R R R R R R
R R R R ( R R R R R ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_dism.pyt get_capabilities� s "
c C@ sN t j j j t d d � d k r> t d j t d � � � n t d d d � S( uC
List the capabilities installed on the system
Args:
image (Optional[str]): 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
u osversionu 10i����uI `installed_capabilities` is not available on this version of Windows: {0}u Capability Identityu Capabilitiesu Installed( R R R R R R R R ( R ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_dism.pyt installed_capabilities� s
"c C@ sN t j j j t d d � d k r> t d j t d � � � n t d d d � S( uC
List the capabilities available on the system
Args:
image (Optional[str]): 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
u osversionu 10i����uI `installed_capabilities` is not available on this version of Windows: {0}u Capability Identityu Capabilitiesu Not Present( R R R R R R R R ( R ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_dism.pyt available_capabilities� s
"c C@ s� t d | r d j | � n d d d j | � g } | rR | j d j | � � n | rq | j d j | � � n | r� | j d � n | r� | j d � n | s� | j d
� n t d | � S( u|
Install a feature using DISM
Args:
feature (str): The feature to install
package (Optional[str]): 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
source (Optional[str]): The optional source of the capability. Default
is set by group policy and can be Windows Update
limit_access (Optional[bool]): Prevent DISM from contacting Windows
Update for the source package
enable_parent (Optional[bool]): True will enable all parent features of
the specified feature
image (Optional[str]): 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 (Optional[bool]): Reboot the machine if required by the install
Returns:
dict: A dictionary containing the results of the command
CLI Example:
.. code-block:: bash
salt '*' dism.add_feature NetFx3
u /Quietu
/Image:{0}u /Onlineu /Enable-Featureu /FeatureName:{0}u /PackageName:{0}u /Source:{0}u /LimitAccessu /Allu
/NoRestartu cmd.run_all( R R R R
( t featuret packageR! R" t
enable_parentR R# R ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_dism.pyt add_feature s #c C@ sm t d | r d j | � n d d d j | � g } | rI | j d � n | s_ | j d � n t d | � S( u�
Disables the feature.
Args:
feature (str): The feature to uninstall
remove_payload (Optional[bool]): Remove the feature's payload. Must
supply source when enabling in the future.
image (Optional[str]): 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 (Optional[bool]): Reboot the machine if required by the install
Returns:
dict: A dictionary containing the results of the command
CLI Example:
.. code-block:: bash
salt '*' dism.remove_feature NetFx3
u /Quietu
/Image:{0}u /Onlineu /Disable-Featureu /FeatureName:{0}u /Removeu
/NoRestartu cmd.run_all( R R R R
( R) t remove_payloadR R# R ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_dism.pyt remove_feature< s c C@ s� t d | r d j | � n d d g } | rk d | k rR | j d j | � � qk | j d j | � � n t d | � } d } t j | | t j � } | j � | S(
uU
List features on the system or in a package
Args:
package (Optional[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
This can also be the name of a package as listed in
``dism.installed_packages``
image (Optional[str]): 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
u /Englishu
/Image:{0}u /Onlineu
/Get-Featuresu ~u /PackageName:{0}u /PackagePath:{0}u cmd.runu Feature Name : (.*)\r\n( R R R R
R R R R ( R* R R R R t features( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_dism.pyt get_features` s
c C@ s t d d d � S( u�
List the features installed on the system
Args:
image (Optional[str]): 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
u Feature Nameu Featuresu Enabled( R ( R ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_dism.pyt installed_features� s c C@ s t d d d � S( u�
List the features available on the system
Args:
image (Optional[str]): 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
u Feature Nameu Featuresu Disabled( R ( R ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_dism.pyt available_features� s c C@ s� t d | r d j | � n d d d j | � g } | rI | j d � n | r_ | j d � n | su | j d � n t d | � S(
u
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 (Optional[bool]):
Skip installation of the package if the applicability checks fail
prevent_pending (Optional[bool]):
Skip the installation of the package if there are pending online
actions
image (Optional[str]):
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 (Optional[bool]):
Reboot the machine if required by the install
Returns:
dict: A dictionary containing the results of the command
CLI Example:
.. code-block:: bash
salt '*' dism.add_package C:\Packages\package.cab
u /Quietu
/Image:{0}u /Onlineu /Add-Packageu /PackagePath:{0}u /IgnoreChecku /PreventPendingu
/NoRestartu cmd.run_all( R R R R
( R* t ignore_checkt prevent_pendingR R# R ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_dism.pyt add_package� s (c C@ s� t d | r d j | � n d d g } | s= | j d � n d | k rb | j d j | � � n | j d j | � � t d | � S(
u�
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 (Optional[str]): 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 (Optional[bool]): Reboot the machine if required by the install
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
u /Quietu
/Image:{0}u /Onlineu /Remove-Packageu
/NoRestartu ~u /PackageName:{0}u /PackagePath:{0}u cmd.run_all( R R R R
( R* R R# R ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_dism.pyt remove_package� s c C@ s t d d d � S( u�
List the packages installed on the system
Args:
image (Optional[str]): 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
u Package Identityu Packagesu Installed( R ( R ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_dism.pyt installed_packages! s c C@ s t d | r d j | � n d d g } d | k rL | j d j | � � n | j d j | � � t d | � } | d d
k r� t � } xr t j | d � j � D]N } d | k r� | j d � } t | � d
k r� q� n | d | | d
<q� q� Wn | } | S( u�
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 (Optional[str]): 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
u /Englishu
/Image:{0}u /Onlineu /Get-PackageInfou ~u /PackageName:{0}u /PackagePath:{0}u cmd.run_allu retcodei u stdoutu : i i (
R R R R
t dictR t text_typet
splitlinest splitt len( R* R R R t rett linet info( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_dism.pyt package_info6 s$ (/ t __doc__t
__future__R R R t loggingt osR t salt.utils.platformR t salt.utils.versionst salt.extR t getLoggert __name__t logR R R R t OSErrort patht existst joint environt gett bin_pathR t traceR
t NoneR R R$ R% R& R' R( R, R. R0 R1 R2 R5 R6 R7 R@ ( ( ( s9 /usr/lib/python2.7/site-packages/salt/modules/win_dism.pyt <module> s\ -$!
1) ( 0$4 4+
Mini Shell