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.
salt.modules.win_dism.add_capability(capability, source=None, limit_access=False, image=None, restart=False)¶Install a capability
| Parameters: |
|
|---|---|
| Raises: |
|
| Returns: | A dictionary containing the results of the command |
| Return type: |
CLI Example:
salt '*' dism.add_capability Tools.Graphics.DirectX~~~~0.0.1.0
salt.modules.win_dism.add_feature(feature, package=None, source=None, limit_access=False, enable_parent=False, image=None, restart=False)¶Install a feature using DISM
| Parameters: |
|
|---|---|
| Returns: | A dictionary containing the results of the command |
| Return type: |
CLI Example:
salt '*' dism.add_feature NetFx3
salt.modules.win_dism.add_package(package, ignore_check=False, prevent_pending=False, image=None, restart=False)¶Install a package using DISM
| Parameters: |
|
|---|---|
| Returns: | A dictionary containing the results of the command |
| Return type: |
CLI Example:
salt '*' dism.add_package C:\Packages\package.cab
salt.modules.win_dism.available_capabilities(image=None)¶List the capabilities available on the system
| Parameters: | 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: |
|
| Returns: | A list of available capabilities |
| Return type: |
CLI Example:
salt '*' dism.installed_capabilities
salt.modules.win_dism.available_features(image=None)¶List the features available on the system
| Parameters: | 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: | A list of available features |
| Return type: | list |
CLI Example:
salt '*' dism.available_features
salt.modules.win_dism.get_capabilities(image=None)¶List all capabilities on the system
| Parameters: | 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: |
|
| Returns: | A list of capabilities |
| Return type: |
CLI Example:
salt '*' dism.get_capabilities
salt.modules.win_dism.get_features(package=None, image=None)¶List features on the system or in a package
| Parameters: |
|
|---|---|
| Returns: | A list of features |
| Return type: |
CLI Example:
# 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
salt.modules.win_dism.installed_capabilities(image=None)¶List the capabilities installed on the system
| Parameters: | 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: |
|
| Returns: | A list of installed capabilities |
| Return type: |
CLI Example:
salt '*' dism.installed_capabilities
salt.modules.win_dism.installed_features(image=None)¶List the features installed on the system
| Parameters: | 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: | A list of installed features |
| Return type: | list |
CLI Example:
salt '*' dism.installed_features
salt.modules.win_dism.installed_packages(image=None)¶List the packages installed on the system
| Parameters: | 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: | A list of installed packages |
| Return type: | list |
CLI Example:
salt '*' dism.installed_packages
salt.modules.win_dism.package_info(package, image=None)¶Display information about a package
| Parameters: |
|
|---|---|
| Returns: | A dictionary containing the results of the command |
| Return type: |
CLI Example:
salt '*' dism. package_info C:\packages\package.cab
salt.modules.win_dism.remove_capability(capability, image=None, restart=False)¶Uninstall a capability
| Parameters: | |
|---|---|
| Raises: |
|
| Returns: | A dictionary containing the results of the command |
| Return type: |
CLI Example:
salt '*' dism.remove_capability Tools.Graphics.DirectX~~~~0.0.1.0
salt.modules.win_dism.remove_feature(feature, remove_payload=False, image=None, restart=False)¶Disables the feature.
| Parameters: |
|
|---|---|
| Returns: | A dictionary containing the results of the command |
| Return type: |
CLI Example:
salt '*' dism.remove_feature NetFx3
salt.modules.win_dism.remove_package(package, image=None, restart=False)¶Uninstall a package
| Parameters: |
|
|---|---|
| Returns: | A dictionary containing the results of the command |
| Return type: |
CLI Example:
# 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
Docs for previous releases are available on readthedocs.org.
Latest Salt release: 2018.3.3