Package Entitlements

Get-LiquitPackageEntitlement

Synopsis

This command displays a list of all entitlements associated with a package. Alternatively, you can use this command to select a specific entitlement.

Syntax

 Get-LiquitPackageEntitlement 
[-Package] <Package> 
[-LiquitContext <LiquitContext>]  
[<CommonParameters>]

 Get-LiquitPackageEntitlement 
[-Package] <Package> 
[-ID] <string[]> 
[-LiquitContext <LiquitContext>]  
[<CommonParameters>]

Examples

Example 1: Get-LiquitPackageEntitlement

 $package = Get-LiquitPackage -id 00000000-0000-0000-0000-000000000000
 Get-LiquitPackageEntitlement -Package $package

This command displays all entitlements belonging to the specified package.

Example 2: Get-LiquitPackage

 $package = Get-LiquitPackage -id 00000000-0000-0000-0000-000000000000
 Get-LiquitPackageEntitlement -Package $package

This command selects a particular entitlement on the specified package.

New-LiquitPackageEntitlement

Synopsis

This command associates a new entitlement with a package.

Syntax

 New-LiquitPackageEntitlement 
[-Package] <Package> 
[-Identity] <Identity> 
[-Stage {Development | Test | Acceptance | Production}] 
[-Publish {Hidden | Catalog | Workspace | Forced}] 
[-Icons <PackageEntitlementIcons>] 
[-Events <PackageEntitlementEvent[]>] 
[-LiquitContext <LiquitContext>] 
[-WhatIf]
[-Confirm]
[<CommonParameters>]

Examples

Example 1: New-LiquitPackageEntitlement

 $identity = Get-LiquitIdentity -id "source\00000000-0000-0000-0000-000000000000"
 $package = Get-LiquitPackage -id 00000000-0000-0000-0000-000000000000
 New-LiquitPackageEntitlement -Package $package -Identity $identity

This command associates the specified identity with the specified package.

Example 2: New-LiquitPackageEntitlement

 $identity = Get-LiquitIdentity -id "source\00000000-0000-0000-0000-000000000000"
 $package = Get-LiquitPackage -id 00000000-0000-0000-0000-000000000000
 New-LiquitPackageEntitlement -Package $package -Identity $identity -Stage Test

This command associates the specified identity with the specified package and publishes the package to the “Test” stage.

Example 3: New-LiquitPackageEntitlement

 $identity = Get-LiquitIdentity -id "source\00000000-0000-0000-0000-000000000000"
 $package = Get-LiquitPackage -id 00000000-0000-0000-0000-000000000000
 $event = New-Object Liquit.API.Server.V3.PackageEntitlementEvent
 $event.Type = [Liquit.API.Server.V3.PackageEvent]::LiquitLogon
 $event.ActionSet = [Liquit.API.Server.V3.ActionSetType]::Launch

$entitlement = New-LiquitPackageEntitlement -Package $package -Identity $identity -Events @($event)

This command associates the specified identity with the specified package, with an auto-launch configured upon Liquit logon.

Parameters

Set-LiquitPackageEntitlement

Synopsis

This command lets you edit the properties of an entitlement for a package.

Syntax

 Set-LiquitPackageEntitlement 
[-Entitlement] <PackageEntitlement[]>
[-Stage {Development | Test | Acceptance | Production}] 
[-Publish {Hidden | Catalog | Workspace | Forced}] 
[-Approver <bool>] 
[-Icons <PackageEntitlementIcons>] 
[-Events <PackageEntitlementEvent[]>] 
[-LiquitContext <LiquitContext>] 
[-WhatIf]
[-Confirm]  
[<CommonParameters>]

Example

 $identity = Get-LiquitIdentity -id "source\00000000-0000-0000-0000-000000000000"
 $package = Get-LiquitPackage -id 00000000-0000-0000-0000-000000000000
 $packageEntitlement  = Get-LiquitPackageEntitlement -Package $package -Identity $identity 
 Set-LiquitPackageEntitlement -Entitlement $packageEntitlement -Approver $true

This command makes the specified identity an approver for the specified package.

Parameters

Remove-LiquitPackageEntitlement

Synopsis

This command removes an entitlement from a package.

Syntax

 Remove-LiquitPackageEntitlement 
[-Entitlement] <PackageEntitlement[]> 
[-LiquitContext <LiquitContext>] 
[-WhatIf] 
[-Confirm]  
[<CommonParameters>]

Example

 $identity = Get-LiquitIdentity -id "source\00000000-0000-0000-0000-000000000000"
 $package = Get-LiquitPackage -id 00000000-0000-0000-0000-000000000000
 $packageEntitlement  = Get-LiquitPackageEntitlement -Package $package -Identity $identity 
 Remove-LiquitPackageEntitlement -Entitlement $packageEntitlement  

This command removes the specified entitlement from the package.

Parameters