Share via


Get Deployment Status

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:

  1. Application

  2. Program

  3. Task Sequence

  4. 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:

  1. Accepted – No Further Status

  2. Succeeded

  3. Failed

  4. Waiting

  5. 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

  1. From the Activities pane, drag a Get Deployment Status activity to the active runbook.

  2. Double-click the Get Deployment Status activity icon. The Properties dialog box opens.

  3. 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.

  4. For more information about the settings on the General and Run Behavior tabs, see Common Configuration Instructions for all Activities.

  5. Click Finish.

Other Activities

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