Get Deployment Status

Article
10/24/2013

Applies To: System Center 2012 - Orchestrator, System Center 2012 R2 Orchestrator, System Center 2012 SP1 - Orchestrator

The Get Deployment Status activity is used to retrieve the status of an application, program, task sequence, or software update deployment assigned to a computer or collection to determine if a software deployment action has completed.

To deploy an application (using the new Configuration Manager application model), use the Deploy Application activity. To deploy a task sequence, use the Deploy Task Sequence activity. To deploy software updates in an update group, use the Deploy Software Update activity. To deploy a legacy application, use the Deploy Program activity

For the procedure to configure this object, see: Configuring the Get Deployment Status Activity

Properties and Published Data

The following tables list the properties and published data for this activity.

Get Deployment Status Properties

Element	Description
Deployment Type	The type of deployment for which you want to retrieve information. Options are: Application Program Task Sequence Software Update
Filters	Filters available are dependent on the type of deployment selected. Filters modify the query sent to Configuration Manager so that the data returned to Orchestrator is already limited to desired results. This improves performance over returning all data and filtering at the Orchestrator server. To add new filter criteria, click Add, select the property on which to filter, select a Relation, and then enter a value for the filter. The type of relation value available will depend on the data type of the property selected.

Deployment Type

The type of deployment for which you want to retrieve information. Options are:

Application
Program
Task Sequence
Software Update

Filters

Filters available are dependent on the type of deployment selected. Filters modify the query sent to Configuration Manager so that the data returned to Orchestrator is already limited to desired results. This improves performance over returning all data and filtering at the Orchestrator server.

To add new filter criteria, click Add, select the property on which to filter, select a Relation, and then enter a value for the filter.

The type of relation value available will depend on the data type of the property selected.

Get Deployment Status Published Data

The following values are published in addition to the input values above:

Element	Description
Connection	Specifies the name of the connection to the Configuration Manager server
Result Count	The number of values returned by the query.

The following tables list the Published Data for the available Deployment Types.

Program or Task Sequence

Element	Description
AdvertisementID	ID of the advertisement (deployment)
LastAcceptanceMessageID	Last acceptance status message ID
LastAcceptanceMessageIDName	Short description of the last acceptance status message
LastAcceptanceMessageIDSeverity	Error: 3221225472 Warning: 2147483648 Informational: 1073741824
LastAcceptanceState	Numeric category of the last acceptance status message
LastAcceptanceStateName	Short description of the acceptance category
LastAcceptanceStatusTime	Date and time, in Universal Coordinated Time (UTC), when the last acceptance message was generated
LastExecutionContext	User context (account) under which the program ran
LastExecutionResult	Last string returned by a status Management Information Format (MIF) file (messages 10007 and 10009) or an error return code (10006)
LastState	Numeric category of the last delivery status message
LastStateName	Short description of the delivery category, including: Accepted – No Further Status Succeeded Failed Waiting No Status
LastStatusMessageID	Last delivery status message ID
LastStatusMessageIDName	Short description of the last delivery status message.
LastStatusMessageIDSeverity	Error: 3221225472 Warning: 2147483648 Informational: 1073741824
LastStatusTime	Date and time, in Universal Coordinated Time (UTC), when the last delivery message was generated
ResourceID	Resource ID of the device

Application

Element	Description
AppCI	Application CI
AppName	The name of the application
AppStatusType	App status type
AssignmentID	ID of the advertisement (deployment)
AssignmentUniqueID	GUID of the application
CollectionID	ID of the collection this resource belongs to
CollectionName	The name of the collection
ComplianceState	The compliance state for the configuration item.
DTCI	The ID of the Deployment Type used in this deployment
DTModelID	The ID of the Deployment Type Model
DTName	The name of the Deployment Type used for this deployment
DTResultID	Deployment Type Result ID
DeploymentIntent	0 = Required, 1 = Available
EnforcementState	The enforcement state. Possible values are: 0 Enforcement State Unknown 1 Enforcement Started 2 Enforcement waiting for content 3 Waiting for another installation to complete 4 Waiting for maintenance window before installing 5 Restart required before installing 6 General failure 7 Pending installation 8 Installing update 9 Pending system restart 10 Successfully installed update 11 Failed to install update 12 Downloading update 13 Downloaded update 14 Failed to download update
ExtendedInfoDescriptionID	Extended information description ID
ExtendedInfoID	Extended information ID
IsMachineAssignedToUser	True or False. True if the machine is assigned to a user.
IsMachineChangesPersisted	True or False. True if the virtual machine changes are persisted.
IsVM	True or False. True if this is a virtual machine.
MachineID	Resource ID of the device
MachineName	Name of the device
PolicyModelID	Policy model ID
Revision	Revision number of the deployment
StartTime	Deployment time
StatusType	Status type: 1 Success 2 In Progress 4 Unknown 5 Error
Technology	The deployment technology type, such as: Windows Installer App-V Script Nokia
UpdateState	Update State
UserName	User name
VMHostName	If the device is a virtual machine, the name of the host for the VM

Software Update

Element	Description
AssignmentID	ID of the advertisement (deployment)
AssignmentName	Name of the advertisement (deployment)
AssignmentUniqueID	GUID of the application
CollectionID	ID of the collection this resource belongs to
CollectionName	The name of the collection
DeviceName	Name of the device where the update is targeted
IsCompliant	True or False
IsMachineAssignedToUser	True or False. True if the machine is assigned to a user.
IsMachineChangesPersisted	True or False. True if the virtual machine changes are persisted.
IsVM	True or False. True if this is a virtual machine.
LastComplianceMessageDesc	Last Compliance Message Description
LastComplianceMessageID	Last Compliance Message ID
LastComplianceMessageTime	Last Compliance Message Time
LastEnforcementErrorCode	Last Enforcement Error Code
LastEnforcementErrorID	Last Enforcement Error ID
LastEnforcementErrorTime	Last Enforcement Error Time
LastEnforcementMessageDesc	Last Enforcement Message Description
LastEnforcementMessageID	Last Enforcement Message ID
LastEnforcementMessageTime	Last Enforcement Message Time
Resource ID	Resource ID of the device
StatusDescription	Status description
StatusEnforcementState	Additional enforcement state for progress and error status (0 for others).
StatusErrorCode	Additional error code for error status (0 for others)
StatusTime	Status time
StatusType	Status type
UserID	User ID
VMHostName	If the device is a virtual machine, the name of the host for the VM

Configuring the Get Deployment Status Activity

To configure the Get Deployment Status activity

From the Activities pane, drag a Get Deployment Status activity to the active runbook.
Double-click the Get Deployment Status activity icon. The Properties dialog box opens.
Configuring the Details tab:
1. In the Connection section, click the ellipsis button (...), and then select the Configuration Manager server connection that you want to use for this activity. Click OK.
2. In the Fields section, enter a value for each of the required properties. If the property is Lookup-enabled, you can click the ellipsis (…) button next to the text box to browse for a value.
  
  You can also use published data to automatically populate the value of the property from the data output by a previous activity in the runbook.
For more information about the settings on the General and Run Behavior tabs, see Common Configuration Instructions for all Activities.
Click Finish.

Other Activities

The Integration Pack for System Center Configuration Manager contains the following additional activities: