Deployment Assignments

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-LiquitDeploymentAssignment

Synopsis

This command displays a list of all assignments of a defined deployment, or you can select a specific deployment assignment.

Syntax

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

 Get-LiquitDeploymentAssignment 
	[-Deployment] <Deployment>
	[-ID] <string[]> 
	[-LiquitContext <LiquitContext>]  
	[<CommonParameters>]

Example

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

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

New-LiquitDeploymentAssignment

Synopsis

This command assigns an identity to a deployment.

Syntax

 New-LiquitDeploymentAssignment 
    [-Deployment] <Deployment> 
    [-Identity] <Identity> 
    [-Stage {Development | Test | Acceptance | Production}] 
    [-LiquitContext <LiquitContext>] 
    [ -Context] <Context>]
    [-WhatIf] 
    [-Confirm]  
    [<CommonParameters>]
    
New-LiquitDeploymentAssignment 
    [-Deployment] <Deployment> 
    [-Device] <Device> 
    [-Stage {Development | Test | Acceptance | Production}]
    [-LiquitContext <LiquitContext>]
    [-WhatIf] 
    [-Confirm]
    [<CommonParameters>]

New-LiquitDeploymentAssignment 
    [-Deployment] <Deployment>
    [-DeviceCollection] <DeviceCollection> 
    [-Stage {Development | Test | Acceptance | Production}] 
    [-LiquitContext <LiquitContext>]
    [-WhatIf]
    [-Confirm]  
    [<CommonParameters>]

New-LiquitDeploymentAssignment 
    [-Deployment] <Deployment> 
    [-Context] <Context> 
    [-Stage {Development | Test | Acceptance | Production}]
    [-LiquitContext <LiquitContext>] 
    [-WhatIf] 
    [-Confirm]
    [<CommonParameters>]

Examples

The following script fetches a deployment and a device by their IDs and creates a new assignment linking the deployment to the device in Application Workspace:

 $deployment = Get-LiquitDeployment -id 00000000-0000-0000-0000-000000000000
 $device = Get-LiquitDevice -id 00000000-0000-0000-0000-000000000000
 New-LiquitDeploymentAssignment -Deployment $deployment -Identity $device

The following script creates a new assignment in the selected deployment:

 $deployment = Get-LiquitDeployment -id 00000000-0000-0000-0000-000000000000
 $context = Get-LiquitContext -id 00000000-0000-0000-0000-000000000000
 New-LiquitDeploymentAssignment -Deployment $deployment -Context $context

Parameters

Name	Value	Description	Required	Default value
Deployment	`<Deployment>`	The deployment to which the assignment is appended.	Yes
Identity	`<Identity>`	The identity to be assigned, which can be either devices or device collections.	If context is not supplied
Context	`<Context>`	The context to be assigned.	If identity is not supplied
Device	`<Device>`	The device to be assigned.
DeviceCollection	`<DeviceCollection>`	The device collection to be assigned.
Stage	`<bool>`	The stage of the deployment actions that should be published to the identity.	No	True
LiquitContext	`<LiquitContext>`	Determines the selected zone.	No	Default

Set-LiquitDeploymentAssignment

Synopsis

This command lets you edit the properties of a deployment.

Syntax

 Set-LiquitDeploymentAssignment 
	[-Assignment] <DeploymentAssignment[]> 
	[-Stage {Development | Test | Acceptance | Production}] 
	[-LiquitContext <LiquitContext>] 
	[-WhatIf] 
	[-Confirm]  
	[<CommonParameters>]

Example

The following script changes the deployment assignment to the "Test" stage:

 $deployment = Get-LiquitDeployment -id 00000000-0000-0000-0000-000000000000
 $deploymentAssignment = Get-LiquitDeploymentAssignment -Deployment $deployment -id 00000000-0000-0000-0000-000000000000
 Set-LiquitDeploymentAssignment -Assignment $deploymentAssignment -Stage Test

Parameters

Name	Value	Description	Required	Default value
Assignment	`<DeploymentAssignment[]>`	The deployment assignment to be updated.	Yes
Stage	`{Development \| Test \| Acceptance \| Production}`	Determines which stages will be published to the assignment.	No
LiquitContext	`<LiquitContext>`	Determines the selected zone.	No	Default

Remove-LiquitDeploymentAssignment

Synopsis

Removes a defined deployment assignment.

Syntax

 Remove-LiquitDeploymentAssignment 
	[-Assignment] <DeploymentAssignment[]> 
	[-LiquitContext <LiquitContext>] 
	[-WhatIf] 
	[-Confirm]  
	[<CommonParameters>]

Example

The following script removes the selected deployment assignment from the Application Workspace:

 $deployment = Get-LiquitDeployment -id 00000000-0000-0000-0000-000000000000
 $deploymentAssignment = Get-LiquitDeploymentAssignment -Deployment $deployment -id 00000000-0000-0000-0000-000000000000
 Remove-LiquitDeploymentAssignment -Assignment $deploymentAssignment

Parameters

Name	Value	Description	Required	Default value
Assignment	`<DeploymentAssignment[]>`	The deployment assignment you wish to remove.	Yes
LiquitContext	`<LiquitContext>`	Determines the selected zone.	No	Default