Packages

21 Mar 2024
4 Minutes to read

Print
Share
Dark
Light
PDF

Packages

Updated on 21 Mar 2024
4 Minutes to read

Print
Share
Dark
Light
PDF

Article Summary

Share feedback

Thanks for sharing your feedback!

Get-LiquitPackage

Synopsis

This command displays a list of all packages defined within the Liquit zone, or you can select a specific package.

Syntax

 Get-LiquitPackage 
    [-LiquitContext <LiquitContext>]  
    [<CommonParameters>]

 Get-LiquitPackage 
    [-ID] <guid[]> 
    [-LiquitContext <LiquitContext>]  
    [<CommonParameters>]

 Get-LiquitPackage 
    [-EntityRef] <EntityRef[]> 
    [-LiquitContext <LiquitContext>]  
    [<CommonParameters>]

 Get-LiquitPackage 
    [-Type] <string[]> 
    [-LiquitContext <LiquitContext>]  
    [<CommonParameters>]

Examples

Example 1: Get-LiquitPackage

 Get-LiquitPackage | Select id, name

This command displays a table with all packages, with their ID and name columns.

Example 2: Get-LiquitPackage

 Get-LiquitPackage -type Web

This command selects all packages of the web type.

Example 3: Get-LiquitPackage

 Get-LiquitPackage -id 00000000-0000-0000-0000-000000000000

This command selects a specific package.

New-LiquitPackage

Synopsis

This command creates a new package.

Syntax

 New-LiquitPackage 
    [-Name] <string> 
    [-Type] <string> 
    [-DisplayName <string>] 
    [-Description <string>] 
    [-Enabled <bool>] 
    [-Offline <bool>] 
    [-Web <bool>] 
    [-Icon <Content>] 
    [-LiquitContext <LiquitContext>] 
    [-WhatIf] 
    [-Confirm]
    [<CommonParameters>]

Example

    New-LiquitPackage -name PowerShellPackage -type Web -Web $true -icon (New-LiquitContent -path C:\path\file.jpg)

This command creates a new package with the name "PowerShellPackage", of the "Web" type. The package will be available without an Agent.

Parameters

Name	Value	Description	Required	Default value
Name	`<string>`	Provide a name for the package.	Yes
Type	`<string>`	Provide a type for the package. Although this is a string value, the following types have custom images: Install Custom Launch Remote Remote Control Web	Yes
DisplayName	`<string>`	Provide a display name for the package.	No
Description	`<string>`	Provide a description for the package.	No
Enabled	`<bool>`	Determines whether or not the package is enabled.	No	True
Offline	`<bool>`	Determines whether or not the package is available in offline mode.	No	False
Web	`<bool>`	Determines whether or not a package is available without an Agent.	No	False
Icon	`<content>`	Upload an icon to the package.	No
LiquitContext	`<LiquitContext>`	Determines the selected zone.	No	Default

Set-LiquitPackage

Synopsis

This command lets you edit the properties of a package.

Syntax

 Set-LiquitPackage 
    [-Package] <Package[]> 
    [-Name <string>] 
    [-Type <string>] 
    [-DisplayName <string>] 
    [-Description <string>] 
    [-Enabled <bool>] 
    [-Offline <bool>] 
    [-Web <bool>]
    [-Icon <Content>] 
    [-LiquitContext <LiquitContext>] 
    [-WhatIf] 
    [-Confirm]  
    [<CommonParameters>]

Example

	$package = Get-LiquitPackage -id 00000000-0000-0000-0000-000000000000
    Set-LiquitPackage -Package $package -Type Launch -Name PowerShellPackage -DisplayName "PowerShell Package" -Description "Description" -Enabled $true

This command updates an existing package and renames it "PowerShellPackage"; users will see this package as "PowerShell Package" in the Catalog or Workspace tabs. The description of the package will be "Description".

Parameters

Name	Value	Description	Required	Default value
Name	`<string>`	Provide a name for the package.	Yes
Type	`<string>`	Provide a type for the package. Although this is a string value, the following types have custom images: Install Custom Launch Remote Remote Control Web	Yes
DisplayName	`<string>`	Provide a display name for the package.	No
Description	`<string>`	Provide a description for the package.	No
Enabled	`<bool>`	Determines whether or not the package is enabled.	No	True
Offline	`<bool>`	Determines whether or not the package is available in offline mode.	No	False
Web	`<bool>`	Determines whether or not a package is available without an Agent.	No	False
Icon	`<content>`	Upload an icon to the package.	No
LiquitContext	`<LiquitContext>`	Determines the selected zone.	No	Default

Copy-LiquitPackage

Synopsis

This command copies a package.

Syntax

 Copy-LiquitPackage 
    [-Snapshot] <PackageSnapshot> 
    [-Name] <string> 
    [-Publish {Development | Test | Acceptance | Production}] 
    [-LiquitContext <LiquitContext>] 
    [-WhatIf] 
    [-Confirm]
    [<CommonParameters>]

Example

	$package = Get-LiquitPackage -id 00000000-0000-0000-0000-000000000000
	$snapshot = $package | Get-LiquitPackageSnapshot -id 00000000-0000-0000-0000-000000000000
    Copy-LiquitPackage -snapshot $snapshot -Name PowerShellPackage

This command creates a new package with a copy of the selected snapshot.

Parameters

Name	Value	Description	Required	Default value
Snapshot	`<PackageSnapshot>`	The snapshot you wish to copy.	Yes
Name	`<string>`	The name of the new package.	Yes
Publish	`{Development \| Test \| Acceptance \| Production}`	Choose the stage where you want to publish the snapshot.	No	Development
LiquitContext	`<LiquitContext>`	Determines the selected zone.	No	Default

Import-LiquitPackage

Synopsis

This command lets you import a resource and deliver it as a package.

Syntax

 Import-LiquitPackage 
    [-Resource] <Resource> 
    [-Name] <string> 
    [-Publish {Development | Test | Acceptance | Production}] 
    [-Type {Default | Managed | Unmanaged}]
    [-LiquitContext <LiquitContext>] 
    [-IgnoreMissingDependencies]
    [-Update]
    [-WhatIf] 
    [-Confirm]
    [<CommonParameters>]

Example

    $connector = Get-LiquitConnector -id 00000000-0000-0000-0000-000000000000
    $resource = Get-LiquitResource -Connector $connector -id 00000000-0000-0000-0000-000000000000
    Import-LiquitPackage -Resource $resource

This command creates a new package with a copy of the selected snapshot.

Parameters

Name	Value	Description	Required	Default value
Resource	`<Resource>`	The resource to use as a basis for a new package or when updating one.	Yes
Name	`<string>`	The alternative name for the package.	No
Publish	`{Development \| Test \| Acceptance \| Production}`	Choose the stage where you want to publish the snapshot.	No	Development
Type	`{Default \| Managed \| Unmanaged}`	The type of package to be created: Default - it takes the type you set in Connectors > Overview > Default package type. Managed - the package is managed by the connector; several options cannot be changed in order to allow easy updates. Unmanaged - the package will be created based on the resource and you can make any changes to it.	No	Default
IgnoreMissingDependencies		Ignore missing dependencies on creation/update.	No
Update		Update an existing package with the same name, otherwise an error is generated if a package with the same name exists.	No
LiquitContext	`<LiquitContext>`	Determines the selected zone.	No	Default

Remove-LiquitPackage

Synopsis

This command removes a package from the Liquit Workspace.

Syntax

 Remove-LiquitPackage 
	[-Package] <Package[]> 
	[-LiquitContext <LiquitContext>] 
	[-WhatIf]
 	[-Confirm]  
	[<CommonParameters>]

Example

	 $package = Get-LiquitPackage -id 00000000-0000-0000-0000-000000000000
	 Remove-LiquitPackage -package $package

This command removes the selected package from the Liquit Workspace.

Parameters

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

Was this article helpful?

What's Next

Package Entitlements

Table of contents

Get-LiquitPackage
New-LiquitPackage
Set-LiquitPackage
Copy-LiquitPackage
Import-LiquitPackage
Remove-LiquitPackage