Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This option is obviously very useful when testing and debugging WuInstall scripts or when running WuInstall with a scheduled job or on remote machines.

/logfile_append file-to-log

The option /logfile_append is similar to /logfile, with the difference that the entries are appended at the end of the specified file, instead of creating a new file.

/log_as_ansi

This option creates a ANSI-logfile. It must be combined with /logfile or /log_append.

/maxruntime minutes

This option starts a timer with the specified number of minutes at the start of WuInstall and exits WuInstall (if it is not finished before the timer expires) with exit code 12. It exits at any case, no matter how far the execution of WuInstall is.

For example, with /maxruntime 5, WuInstall exits after 5 minutes displaying

Code Block
languagetext
themeEmacs
Maxruntime timeout elapsed: 5, exiting process!

This option is intended for machines, where downloads take a lot of time, or machines, which hang for some reason, to prevent WuInstall from running endlessly.

Use this option with caution, especially when using the /use_wsus or /bypass_wsus options!

/simple_error

With this option, WuInstall returns 0 for any success and 1 for any error, regardless of the reason.

Which means, if the return code would be 0, 2, 3, 5 or 10, WuInstall returns 0 and displays the message

Code Block
languagetext
themeEmacs
 Simple result specified, returning 0 for success!

In any other case (the remaining codes 1, 4, 6, 11, 12), WuInstall returns 1 and displays the message

Code Block
languagetext
themeEmacs
 Simple result specified, returning 1 for error!

/show_progress

This option shows the progress for the download of every single update and the installation of the updates, using asynchronous downloads / installation.

On some machines under certain circumstances, the /show_progress option might cause problems, so use it only when manually testing scripts or searching for problems on a single workstation. It is not advised to use it in automated scripts on different workstations.

This feature is not recommended for the productive use of WuInstall!

/offline

This options STOPS WuInstall from connecting to the WSUS Server, or Microsoft Update site when searching updates. Instead it searches offline.

This option is quite useful for searching already installed updates. The criteria "IsInstalled=1" and the /uninstall option automatically trigger an offline search.

...

When not using IsInstalled=1, the search result list usually contains the updates found at the last online search.

/quiet

The update-installer is forced to do an installation without user interaction.

/disableprompt

Disables showing source prompts to a user when installing the updates.

/silent

Suppresses any console output (log file option is still working).

/donothing [retcode]

WuInstall takes no action and returns the specified retcode, 0 by default.

/xmlout file

Writes an XML report to the specified file. This file contains additional information about the machine.


Code Block
languagexml
themeEmacs
 <?xml version="1.0" encoding="UTF-8"?>
<wuinstall runtime_seconds="10" runtime="0d 00:00:10">
        <system-info>
                <wuinstall-version>WuInstall Version 2.0 Pro (codename AE), Build 2014-02-03</wuinstall-version>
                <windows>
                        <version>Microsoft Windows [Version 6.2.9200]</version>
                        <service-pack>No Service Pack installed!</service-pack>
                        <windows-update-agent>
                                <major-version>8</major-version>
                                <minor-version>0</minor-version>
                                <product-version>7.9.9600.16384</product-version>
                        </windows-update-agent>
                        <domain>WORKGROUP</domain>
                        <username>Michael</username>
                        <computername>MICHAEL-PC</computername>
                </windows>
                <processor-architecture>x86</processor-architecture>
                <WOW64>true</WOW64>
        </system-info>
        <wsus></wsus>
        <parameters>/search /xmlout c:\tmp\wuinstall.xml</parameters>
        <updates count="1">
        <update>
                <title>Definition Update for Windows Defender - KB2267602 (Definition 1.173.1428.0)</title>
                <description>Install
 this update to revise the definition files that are used to detect 
viruses, spyware, and other potentially unwanted software. Once you have
 installed this item, it cannot be removed.</description>
                <download_priority>Normal</download_priority>
                <eula_accepted>true</eula_accepted>
                <identity>4f25e1f8-186e-4d0b-b18c-6dab7c081c09</identity>
                <is_beta>false</is_beta>
                <is_downloaded>false</is_downloaded>
                <is_hidden>false</is_hidden>
                <is_installed>false</is_installed>
                <is_mandatory>false</is_mandatory>
                <is_present>true</is_present>
                <is_uninstallable>false</is_uninstallable>
                <kb_article_ids>
                        <kb_article_id>2267602</kb_article_id>
                </kb_article_ids>
                <last_deployment_change_time>2014-05-06</last_deployment_change_time>
                <max_download_size>127745424</max_download_size>
                <min_download_size>0</min_download_size>
                <msrc_severity></msrc_severity>
                <recommended_cpu_speed>0</recommended_cpu_speed>
                <recommended_hard_disk_space>0</recommended_hard_disk_space>
                <recommended_memory>0</recommended_memory>
                <support_url>http://go.microsoft.com/fwlink/?LinkId=52661</support_url>
                <update_type>Software</update_type>
                <categories>
                <category>
                <id>e0789628-ce08-4437-be74-2495b842f43b</id>
                <description>A
 broadly-released and frequent software update containing additions to a
 product's definition database. Definition databases are often used to 
detect objects with specific attributes, such as malicious code, 
phishing Web sites, or junk e-mail.</description>
                <name>Definition Updates</name>
                <order>-1</order>
                <type>UpdateClassification</type>
                </category>
                <category>
                <id>8c3fcc84-7410-4a95-8b89-a166a0190486</id>
                <description>Windows
 Defender helps protect your computer against pop-ups, slow performance,
 and security threats caused by spyware and other unwanted 
software.</description>
                <name>Windows Defender</name>
                <order>-1</order>
                <type>Product</type>
                </category>
                </categories>
                <download_result_code>NotStarted</download_result_code>
                <download_hresult></download_hresult>
                <download_hresult_text></download_hresult_text>
                <installation_result_code>NotStarted</installation_result_code>
                <installation_hresult></installation_hresult>
                <installation_hresult_text></installation_hresult_text>
                <reboot_required>false</reboot_required>
        </update>
        </updates>
        <result>
                <search_result>Succeeded</search_result>
                <return_code>0</return_code>
                <return_text></return_text>
                <reboot_required>false</reboot_required>
        </result>
</wuinstall>

/includeRecommendedUpdates

Includes recommended and optional updates.

/IncludePotentiallySupersededUpdates 0|1

Includes potentially superseded updates.

/disable_ie_firstruncustomize

Disables the Internet Explorer 8 set up dialog.

/targetgroup "targetgroup" 

One of the nice things about WSUS is that it allows you to use client side targeting. The idea behind client side targeting is that you can set up different computer groups, and you can roll out updates on a group basis. Client side targeting isn’t used by default, but if you decide to use it, you can use this option to assign the computer to a target group.

/offlinescan "scanfile"

This option can be used to search for updates against a cab-file. You can download the cab-file from the following link:

http://go.microsoft.com/fwlink/?LinkID=74689

...

Use this option when you try to update a machine which gets a lot of updates from a WSUS server. Obtaining a lot of updates from a WSUS can cause a search to fail (because of a limit from the WSUS which is not configurable). Perform multiple searches to get a result.

/extended_error

Use this option to get a more specific return code as a bitmap:

  • 1: Set if an error occured
  • 2: Set if updates where found which mach the specified filter
  • 4: Set if updates where found
  • 8: Set if the maxUpdateCount was reached
  • 16: Set if a reboot is required
  • 32: Set if the timeout was reached
  • 64: Set if an invalid criteria was specified
  • 128: Set if there was a syntaxerror in the commandline
  • 256: Set if the license is invalid
  • 512: Set if there is not enough disk space