Tasks
  • 16 Mar 2024
  • 1 Minute to read
  • Dark
    Light
  • PDF

Tasks

  • Dark
    Light
  • PDF

Article summary

Get-LiquitTask

Synopsis

This command displays all the tasks defined in the zone or server. Alternatively, you can use this command to select a specific task.

Syntax

    Get-LiquitTask 
    [[-ID] <guid[]>] 
    [-Search <string>] 
    [-Name <string>] 
    [-State {Queued | InProgress | Success |
    Failed | Cancelled | Suspended | Continue}] 
    [-LiquitContext <LiquitContext>]  
    [<CommonParameters>]

    Get-LiquitTask 
    [-Server] <ServerPrimary> 
    [[-ID] <guid[]>] 
    [-Search <string>] 
    [-Name <string>] 
    [-State {Queued |
    InProgress | Success | Failed | Cancelled | Suspended | Continue}] 
    [-LiquitContext <LiquitContext>]
    [<CommonParameters>]

    Get-LiquitTask 
    [-ScheduledTask] <ScheduledTask> 
    [[-ID] <guid[]>] 
    [-Search <string>] 
    [-Name <string>]
    [-State {Queued | InProgress | Success | Failed | Cancelled | Suspended | Continue}] 
    [-LiquitContext <LiquitContext>]
    [<CommonParameters>]

Examples

Get-LiquitTask Example 1

  $taskList = Get-LiquitTask -State Failed 

This command generates a list of all the failed tasks in the current system.

Get-LiquitTask Example 2

   $server = Get-LiquitServer -id 00000000-0000-0000-0000-00000000
  Get-LiquitTask -Server $server

This command retrieves all the tasks running on the specified server.

You cannot get a list of tasks running on a satellite server by this method.

Parameters

NameValueDescriptionRequiredDefault value
ID<guid[]>The GUID belonging to the task.No
Search<string>This parameter can be used to search for a scheduled task.No
Name<string>The name of the scheduled task.No
State{Queued | InProgress | Success | Failed | Cancelled | Suspended | Continue}Select tasks by their state. You can for example select only the failed scheduled tasks.No
Server<guid[]>The GUID belonging to a Liquit Workspace ServerNo
ScheduledTask<ScheduledTask>Select all the tasks spawned by a specific scheduled task.No
LiquitContext<LiquitContext>Determines the selected zone.NoDefault

Wait-LiquitTask

Synopsis

This command waits until a task is finished.

Syntax

 Wait-LiquitTask
	[-ID] <guid> 
	[-Timeout] <int> 
	[-LiquitContext <LiquitContext>]  
	[<CommonParameters>]

 Wait-LiquitTask 
	[-Task] <Task> 
	[-Timeout] <int> 
	[-LiquitContext <LiquitContext>]  
	[<CommonParameters>]

Examples

Example 1: Wait-LiquitTask

 $Zone = Get-LiquitZone -ID 00000000-0000-0000-0000-000000000000
 $Zone | Install-LiquitZoneLicense -Key "00000-00000-00000-00000-0000" | Wait-LiquitTask

This command waits until a specific install is complete.

Example 2: Wait-LiquitTask

 $Zone = Get-LiquitZone -ID 2deef6c0-c302-201b-003b-35b7ad2faa1b
 $Task = Install-LiquitZoneLicense -Zone $Zone -Key "00000-00000-00000-00000-0000"
Wait-LiquitTask -Task $Task

This command waits until a specific install is complete based on a task.

Example 3: Wait-LiquitTask

 Get-LiquitZone -ID 00000000-0000-0000-0000-000000000000

This command waits until a specific install is complete based on an ID.


Was this article helpful?

What's Next