Three radio buttons on the first Configure Agent Settings page:
• Require updates to be installed as soon as they are advertised (/g:0)
• Users can postpone updates indefinitely (no /g parameter)
• Allow users to postpone installation for: (/g:xxx, where xxx is specified in the Allow user to postpone installation box.
Use this switch to set the grace period (in hours) after which the installation of the software update becomes mandatory.
The grace period is based on either the date/time property created when the software update is authorized for deployment, or the date/time property created when each software update is initially inventoried.
To determine when the grace period will expire, the authorized time or detected time (subject to the /d option, below) will be added to the grace period then compared to local time. This calculation is influenced by the Coordinated Universal Time setting.
The range of values for this switch is from zero (0) to 999 hours. The default setting is 336 hours, or 14 days.
If you enter a value of zero (0) for this parameter the grace period expires immediately, making update installation mandatory, with no opportunity to postpone installation.
The /g switch is optional. If you do not specify it, the grace period feature is disabled, and the update will never expire (installation will be optional for users).
The From setting associated with the Allow user to postpone installation setting on the first Configure Agent Settings page.
Use this switch to specify that the grace period is based on the time that the update was first determined to be applicable to the SMS client computer rather than the time the update was authorized.
The default value for this switch, after which the installation of the software update becomes mandatory, is the time of authorization plus the grace period specified by the /g parameter discussed above.
The Report inventory changes only when inventory is scheduled check box on the second Configure Agent Settings page.
Use this switch to suppress the hardware inventory agent from initiating a hardware inventory cycle after update installation.
Initiating hardware inventory at times other than the scheduled hardware inventory frequency can increase network and server load. The /s switch is used as the default setting when the Distribute Software Updates Wizard configures the program command line for the Software Updates Installation Agent.
The After Waiting field on the first Configure Agent Settings page.
Use this switch to specify that the default action that the Software Updates Installation Agent takes on behalf of an unresponsive user is to postpone installation of the update.
If you use this switch, the Software Updates Installation Agent does not install software updates automatically until the installation grace period (specified using the /g parameter) expires. However, each time the advertisement for the update occurs, the user will have the opportunity to install the software updates even if the grace period has not expired.
By default, without the /p switch, the Software Updates Installation Agent automatically installs the updates for unresponsive users after the countdown period specified using the /c parameter expires.
Force installation of required updates only check box, on the first Configure Agent Settings page.
Use this switch to enforce the grace period for each update individually, rather than enforcing the grace period for the group of updates within the same SMS package.
When you specify this switch, the Software Updates Installation Agent applies grace period expiration to individual updates, rather than to an entire package of updates. This means that mandatory installation only takes place for software updates for which the installation grace period has expired.
With the /i parameter in effect, when the user clicks Install Now in the Software Updates Installation Agent user interface, expired updates and optional (currently unexpired) updates are both available for installation. The list of updates shown to the user will include expired updates and optional updates with an indication of the state of each update, allowing the user to proactively install unexpired updates along with the expired updates.
Without the /i switch, when one of the updates expires and the user clicks Install Now, all of the updates in the package will install.
The Postpone automated system restarts setting and associated settings on the second Configure Agent Settings page.
Use this switch to suppress automatic post-installation restart requests, and to allow the user to postpone restarting the computer after installation.
This switch can be useful in server environments or in cases where you do not want the computers that are installing the updates to restart by default. However, note that causing a computer to restart after installation ensures that software updates take effect, and that suppressing post-installation restart requests can leave your system in an insecure state.
The s|w|sw arguments allow you to turn off automatic restarts by type of SMS client computer, as follows. (Note that the /z command cannot be used without the s|w|sw arguments)
The default case (without the /z command) allows automatic restarts if required.
/z:w disables automatic restart (if required) for workstations only.
/z:s disables automatic restart (if required) for servers only.
/z:sw disables automatic restart (if required)for both servers and workstations.
The Force client programs to close and discard any unsaved data check box on the second Configure Agent Settings page.
Use this switch to force automatic post-installation restart requests, even if there are running programs with unsaved data on the SMS client computer. This switch takes precedence over the /z switch, above.
Use caution when using this switch. If a computer is forced to restart with this command-line switch in effect, users could lose any unsaved changes on the desktop. Therefore, only use this switch when business needs require that the software updates take effect immediately, regardless of possible data loss.
By default, without the /f switch, the Software Updates Installation Agent uses the built-in Shutdown process of the operating system, allowing each open application to display a File Save dialog to the user.
If you use this switch, the forced restart will only take place if the Software Updates Installation Agent finds indications that a restart is needed. This switch explicitly does not mean that the computers will always be forced to restart after any update installation. If used, this switch only applies to the current scheduled run of the advertisement.
The Specify how long the agent should wait for a user or unresponsive update: setting and associated settings on the first Configure Agent Settings page.
Use this switch to set the countdown period (in minutes) after which the Software Updates Installation Agent will take action on behalf of an unresponsive user. The action taken following the countdown depends on the other settings that have been specified, and can include: automatic installation of the update, postponement of installation, or post-installation system restarts (configured using the /p the /z, and the /f parameters).
This countdown is useful in cases where a software update installation is necessary, but no user is present to provide input. The delays that could be caused by such cases are important, because while the user interface for software update installation is displayed, all other software distribution using SMS is blocked for that computer. After the countdown expires, the update installation cycle proceeds automatically.
Following the installation, if a system restart is needed and has not been explicitly disabled, a countdown begins allowing users time to save their work. The value that you enter for the countdown is used for both the pre-installation countdown (automatic installation if no user input is received) and the post-installation countdown (restart the computer if restart is not suppressed).
The range of values for this switch is from zero (0) to 99 minutes. The default setting is 5 minutes.
If you enter a value of zero (0) for this switch, installation will start immediately.
The Wait <N> minutes for the update and then cancel installation setting on the first Configure Agent Settings page.
Use this switch to set the failsafe timeout (in minutes) after which a software update is considered unresponsive and that particular update installation is terminated.
Because software updates can come from a wide range of sources with a wide array of behaviors, it is recommended that you proceed with the installation of an update even if it appears to have become unresponsive. However, if a software update is permitted to remain unresponsive for a long period of time, it could leave the system in a vulnerable and inconsistent state. Therefore, it is necessary to set the timeout value to allow an unresponsive update to be disabled.
If one or more software updates in a package reach the time-out limit, the Software Updates Installation Agent assumes that a system restart is needed to ensure the system can be restored to a consistent state (this parameter is subject to the /z restart suppression parameter).
The range of values for this switch is from zero (0) to 99 minutes. The default setting is 30 minutes.
If you enter a value of zero (0) for this switch, the update will not be given any time to install. To avoid this problem, a minimum of 10 minutes should be allowed for this timeout value.
The Software Updates Installation Agent will continue to record exit codes for as long as it can. However, after the failsafe timeout has expired, the currently executing update will be terminated and its exit code will indicate failure.
The Use notification balloons or dialogs setting on the third Configure Agent Settings page.
Use this switch to configure the Software Updates Installation Agent to install the specified updates without user interface or interaction. When you specify this switch, the only user interface that appears on the client is the operating system's progress dialog box that indicates that a system restart is being initiated.
Because this switch allows no user interaction by definition, you should not use it in combination with other switches that assume that user interaction is available. In particular, you should not use this switch without also specifying the /g switch, because this would mean that the software updates in the package would be indefinitely postponed. In general, you should specify /g:0 when using /q.
The Create reference computer templates during processing setting on the third Configure Agent Settings page.
Use this switch to create a reference software updates authorization list file that you can use to distribute software updates to your enterprise in an expedited manner. You use this switch when you use a reference computer for expedited approval processing.
When you run Patchinstall.exe with the /x switch, a local copy of the software updates authorization list, type_patchauthorize.xml (where type is the software update type) is output to the temp directory of the current user (%temp%). This file contains a list of all software updates currently applicable to the SMS client computer, whether installed or needed.
The Provide reminders and allow users to reschedule software updates until they become required setting on the third Configure Agent Settings page.
Use this switch to enable the persistent notification icon, an Advanced Client feature that provides local reminders and allows users to reschedule software updates on computers running SMS Advanced Client. This reminder process is independent of the advertisement schedule, and allows the administrator to reduce the advertisement frequency when advertising software updates to collections of computers running the SMS Advanced Client. The interval at which the reminders occur is hard-coded to every three hours.
Users can interact with the notification area icon to:
Check for upcoming installations
Schedule installations and restarts to occur at convenient times of day
Install software updates immediately
Remind users of a need for a restart until the requirement is satisfied, if restart is postponed during initial software update installation
The /n switch has no effect on computers running the SMS Legacy Client.
If the /q switch is specified, the /n switch is ignored.
The Use a change window setting and associated settings on the third Configure Agent Settings page.
Use this switch to specify the duration of the change window (the time within which configuration changes are permitted in scheduled software updates installations.)
The range of values for this parameter is from zero (0) to 480 minutes. The default setting is 90 minutes.
If you enter a value of zero (0) for this parameter, the update will not be given any time to install. To avoid this problem, a minimum of 30 minutes should be allowed for this software update installation window.
The start time for the scheduled software update installation is the scheduled start time for the advertisement. For more information, see Configure Scheduled Software Update Installations in Help.
Accessed with Advanced on the Identify the SMS package page when modifying an existing package authorization.
Use this switch to specify the authorization list file, by default, PatchAuthorize.xml. You can use this option when you want to specify an authorization file other than PatchAuthorize.xml.
Article ID: 961726 - Last Review: 01/16/2015 02:55:34 - Revision: 2.0