The WSA Actions step is an essential component of the WSA deployment task sequence. Its positioning and configuration within the task sequence is critical to ensuring the task sequence completes successfully. The step performs several different functions depending on the selections made when configuring the step.

ActionsNotes

When run, this step:

  1. Contacts the Shopping server and attempts to identify a valid WSA record for the host

Initialization

WSA Actions - Initialize should be placed at the very beginning of the task sequence

Using the Shopping URL provided, the step will attempt to obtain a WSA record/order for the localhost. Only orders in the "TS Running" state are considered. If a valid WSA order is found, the step will download the order attributes and populate the task sequence environment. The many order attributes dictate the behavior of the task sequence. For instance, they indicate if USB media is required, they provide the credentials for the WiFi and VPN connections to be made and indicate if Application Migration is required.

If the step cannot contact the Shopping server it will fail.

Once the attributes have been obtained, if these indicate that USB media is required and it has not been detected, then it will notify user for the USB media.

2. Ensures task sequence referenced content paths, defined in the current task sequence environment, are refreshed and always valid

Refresh Content Locations

WSA Actions - Refresh Content Locations should be placed

Under certain circumstances, a deployment may require the use of USB media for content or user data storage. In the case of content, the environment must reflect the correct local file system path before allowing the task sequence to attempt access. Operations such a restart of the host, re-partition of the disk and installation of the new OS may impact the validity of existing paths. The step updates the paths if required ensuring access to the content is maintained for the running task sequence.

3. Switches the task sequence between online and offline mode, based upon prevailing network connectivity, and attempts to establish a network connection when building over WiFi

 

Switch between online and offline content


WSA Actions - Switch between online and offline content should be placed

If network connectivity is unavailable, and the step is running in WinPE, then the step will configure the task sequence to run in offline media mode. Offline mode requires _SMSTSMediaType is set to FullMedia and the content locations defined in the task sequence environment are set to local file system paths.

When in the full OS, the step will configure the task sequence to run in online mode by setting _SMSTSMediaType to BootMedia if it has been previously set to FullMedia. The step will also attempt to establish a network connection if the deployment is being performed over a WiFi connection.

4. Performs WSA finalization tasks once the main body of the task sequence has completed.

Finalize

WSA Actions - Finalize should be position as the last step in the task sequence.

The step will perform cleanup operations at the end of the task sequence.

USB Cleanup

If USB media was required to complete the deployment, then the step may be required to remove all content stored on the device. Cleanup is based upon the setting made in the WSA deployment published in Shopping.

Content stored on the USB device will always be restored to the local Nomad cache in the new OS.

For any captured user data, this will always be removed from the device if the USMT restore succeeded.

Task Sequence status

The step will record the outcome of the task sequence in the registry:

Software\1E\WSA\TSExecutionHistory\TaskSequenceId

For zero touch restores, the step will also update the order status in Shopping to indicate that the order is closed.

 

Configurable Parameters

ParameterDefault ValueDescription
NameWSA ActionsName for the custom task sequence action
DescriptionAction to configure Windows Servicing Assistant environmentDescription for the custom task sequence action
InitializeCheckedUsed to initialize the deployment
Shopping URL Specifies the URL of the Shopping server
Refresh Content LocationsUncheckedUsed to maintain access to cached content
Switch between online and offline contentUncheckedUsed to ensure the task sequence continues to function when connectivity to the ConfigMgr site is unavailable
FinalizeUncheckedUsed to clean up the deployment