Deployment Actions

  • Updated on Sep 8, 2025
  • Published on Apr 16, 2025
  • 2 minute(s) read
Prev Next

After a deployment runs, the device needs a reboot to get the Agent out of the running deployment state. The Agent configuration file is reverted to the previous state.

The Application Workspace Launcher is not available while deploying.

Get-LiquitDeploymentAction

Synopsis

This command displays a list of all deployment actions belonging to a defined deployment, or you can select a specific deployment action.

Syntax

 Get-LiquitDeploymentAction 
	[-Deployment] <Deployment> 
	[-LiquitContext <LiquitContext>]  
	[<CommonParameters>]

 Get-LiquitDeploymentAction 
	[-Deployment] <Deployment> 
	[-ID] <guid[]> 
	[-LiquitContext <LiquitContext>]  
	[<CommonParameters>]

Example

The following script lists all deployment actions belonging to the specified deployment:

 $deployment = Get-LiquitDeployment -id 00000000-0000-0000-0000-000000000000
 Get-LiquitDeploymentAction -Deployment $deployment

New-LiquitDeploymentAction

Synopsis

This command appends a package action set to a deployment.

Syntax

 New-LiquitDeploymentAction 
	[-Deployment] <Deployment> 
	[-Package] <Package> 
	[-Enabled <bool>]
	[-IgnoreErrors <bool>] 
	[-ActionSet {Distribute | Install | Launch | Uninstall | Repair}] 
	[-LiquitContext <LiquitContext>] 
	[-WhatIf] 
	[-Confirm]  
	[<CommonParameters>]

Example

The following script creates a new deployment action, in the selected deployment:

 $package = Get-LiquitPackage -id 00000000-0000-0000-0000-000000000000
 $deployment = Get-LiquitDeployment -id 00000000-0000-0000-0000-000000000000
 New-LiquitDeploymentAction -Deployment $deployment -Package $package -ActionSet Launch

Parameters

Name Value Description Required Default value
Deployment <Deployment> The deployment to which the action is appended. Yes
Package <Package> The package responsible for the action. Yes
Enabled <bool> Determines whether or not the deployment action is enabled. No True
IgnoreErrors <bool> Determines whether or not errors are ignored. No False
ActionSet {Distribute | Install | Launch | Uninstall | Repair} The action set that should be used for the deployment action. The following options are available:
  • Distribute
  • Install
  • Launch
  • Uninstall
  • Repair
 No Distribute
LiquitContext <LiquitContext> Determines the selected zone. No Default

Set-LiquitDeploymentAction

Synopsis

This command lets you edit the properties of a deployment.

Syntax

 Set-LiquitDeploymentAction 
	[-Action] <DeploymentAction[]> 
	[-Enabled <bool>] 
	[-IgnoreErrors <bool>] 
	[-ActionSet {Distribute | Install | Launch | Uninstall | Repair}] 
	[-LiquitContext <LiquitContext>] 
	[-WhatIf] 
	[-Confirm]  
	[<CommonParameters>]

Example

The following script changes the deployment action to the “Install” action set:

 $deployment = Get-LiquitDeployment -id 00000000-0000-0000-0000-000000000000
 $deploymentAction = Get-LiquitDeploymentAction -Deployment $deployment -id 00000000-0000-0000-0000-000000000000
 Set-deploymentAction -Action $deploymentAction -ActionSet Install

Parameters

Name Value Description Required Default value
Action <DeploymentAction> The deployment action to be updated. Yes
Enabled <bool> Determines whether or not the deployment action is enabled. No True
IgnoreErrors <bool> Determines whether or not errors are ignored. No False
ActionSet {Distribute | Install | Launch | Uninstall |Repair} The action set that should be used for the deployment action. The following options are available:
  • Distribute
  • Install
  • Launch
  • Uninstall
  • Repair
 No Distribute
LiquitContext <LiquitContext> Determines the selected zone. No Default

Remove-LiquitDeploymentAction

Synopsis

Removes a defined deployment action.

Syntax

 Remove-LiquitDeploymentAction 
	[-Action] <DeploymentAction[]> 
	[-LiquitContext <LiquitContext>] 
	[-WhatIf] 
	[-Confirm]  
	[<CommonParameters>]

Example

The following script removes the selected deployment from the Application Workspace.

 $deployment = Get-LiquitDeployment -id 00000000-0000-0000-0000-000000000000
 $deploymentAction = Get-LiquitDeploymentAction -Deployment $deployment -id 00000000-0000-0000-0000-000000000000
 Remove-deploymentAction -Action $deploymentAction

Parameters

Name Value Description Required Default value
Action <Action> The deployment action you wish to remove. Yes
LiquitContext <LiquitContext> Determines the selected zone. No Default