PowerShell CLI 2.0 - Cmdlets - Export-JS7InventoryItem

Name

Export-JS7InventoryItem

SYNOPSIS

Export inventory objects, e.g. workflows, schedules etc. from JOC Cockpit

SYNTAX

Export-JS7InventoryItem [[-Path] <String>] [[-Type] <String[]>] [[-Folder] <String>] [-Recursive] [-Releasable] [-Deployable] [-Released] [-Deployed] [-Valid] [-WithoutRemoved] [-ForSigning] [[-ControllerId] <String>] [[-FilePath] <String>] [[-ArchiveFormat] <String>] [[-AuditComment] <String>] [[-AuditTimeSpent] <Int32>] [[-AuditTicketLink] <Uri>] [<CommonParameters>]

DESCRIPTION

This cmdlet exports inventory objects that are stored with JOC Cockpit.

* Deployable Objects: use of the -Deployable parameter
** Inventory objects such as workflows are deployed to a JS7 Controller. The -Type parameter can be used to restrict object types.
** When exporting deployable objects then either a draft version can be used or the latest deployed version is requested by use of the -Deployed parameter.
* Releasable Objects: use of the -Releasable parameter
** Inventory objects such as calendars and schedules are not deployed to a Controller but are used by JOC Cockpit.
** When exporting releasable objects then either a draft version can be used or the latest released version is requested by use of the -Released parameter.

An export is performed either to backup deployable and releasable objects that later on can be imported (restored),
or to export objects for signing and later depeloyment with a JOC Cockpit operated in security level "high".

The process to export for signigng includes the following steps:

* export deployable objects to a compressed archive (.zip, .tar.gz),
* unzip the archive to the local file system,
* manually sign objects,
* zip signed objects and signature files to a compressed archive,
* import the archive and deploy the signed objects.

PARAMETERS

Path

-Path <String>
Specifies the path and name of an individual inventory object that should be exported, e.g. a workflow.

Type

-Type <String[]>
Optionally restricts the object type to export which is one of:

* Deployable Object Types
** WORKFLOW
** JOBCLASS
** LOCK
** JUNCTION
* Releasable Object Types
** WORKINGDAYSCALENDAR
** NONWORKINGDAYSCALENDAR
** SCHEDULE

The -Type parameter can be used to restrict either deployable or releasable object types to be exported.
Without specifying this parameter objects of any type within the areas of releasable or deployable objects are exported
depending on use of the -Releasable and -Deployable parameters.

Folder

-Folder <String>
Optionally specifies the folder for which all included inventory objects should be exported.
This parameter is used alternatively to the -Path parameter that specifies export of an individual inventory object.

Recursive

-Recursive <SwitchParameter>
Specifies that any sub-folders should be looked up if the -Folder parameter is used.
By default no sub-folders will be searched for exportable objects.

Releasable

-Releasable <SwitchParameter>
Specifies that only releasable objects should be exported that include the object types:

* WORKINGDAYSCALENDAR
* NONWORKINGDAYSCALENDAR
* SCHEDULE

If none of the parameters -Releasable or -Deployable is used then both releasable and deployable inventory objects are exported.

Deployable

-Deployable <SwitchParameter>
Specifies that only deployable objects should be exported that include the object types:

* WORKFLOW
* JOBCLASS
* LOCK
* JUNCTION

If none of the parameters -Releasable or -Deployable is used then both releasable and deployable inventory objects are exported.

Released

-Released <SwitchParameter>
Specifies that no draft versions of the releasable objects will be exported but only released versions.
Without this parameter the unreleased draft version of inventory objects will be exported or the latest released version depending on availability.

Deployed

-Deployed <SwitchParameter>
Specifies that no draft versions of the deployable objects will be exported but only deployed versions.
Without this parameter the undeployed draft version of the inventory object will be exported or the latest deployed version depending on availability.

Valid

-Valid <SwitchParameter>
Specifies that only valid versions of inventory objects are eligible for export. Only draft versions of
inventory objects can be invalid, any deployed or relased versions of inventory objects are valid.
Without this parameter draft versions can be exported that are in progress and therefore are not validated.

WithoutRemoved

-WithoutRemoved <SwitchParameter>
Optionally specifies that no removed objects are added to the export. Such objects are marked for deletion, however,
deletion has not yet been confirmed by a deploy/release operation that permanently erases objects.

ForSigning

-ForSigning <SwitchParameter>
Specifies that deployable objects are exported for external signing and later import into a JOC Cockpit
instance operated for security level "high".

* The export file cannot include releasable objects as such objects are not subject to signing.
* The export file must be created from the same JOC Cockpit instance to which it will be imported for deployment.
* The process of export/signing/import must not exceed the max. idle time that is configured for a user's JOC Cockpit session.

Without this parameter the export file is created for backup purposes and can include any deployable and releasable objects.

ControllerId

-ControllerId <String>
Specifies the ID of the Controller to which objects should be deployed after external signing.
This parameter is required if the -ForSigning parameter is used.

FilePath

-FilePath <String>
Specifies the path to the archive file that the exported inventory objects are written to.

If no file path is specified then an octet stream is returned by the cmdlet.

ArchiveFormat

-ArchiveFormat <String>
Specifies the type of the archive file that will be returned: ZIP, TAR.GZ.

AuditComment

-AuditComment <String>
Specifies a free text that indicates the reason for the current intervention, e.g. "business requirement", "maintenance window" etc.

The Audit Comment is visible from the Audit Log view of JOC Cockpit.
This parameter is not mandatory, however, JOC Cockpit can be configured to enforce Audit Log comments for any interventions.

AuditTimeSpent

-AuditTimeSpent <Int32>
Specifies the duration in minutes that the current intervention required.

This information is visible with the Audit Log view. It can be useful when integrated
with a ticket system that logs the time spent on interventions with JobScheduler.

AuditTicketLink

-AuditTicketLink <Uri>
Specifies a URL to a ticket system that keeps track of any interventions performed for JobScheduler.

This information is visible with the Audit Log view of JOC Cockpit.
It can be useful when integrated with a ticket system that logs interventions with JobScheduler.

RELATED LINKS

about_JS7

EXAMPLES

-------------------------- EXAMPLE 1 --------------------------

PS > Export-JS7InventoryItem | Out-File /tmp/export.zip

Exports all inventory objects to a zipped octet-stream that is written to a file. This includes deployable and releasable inventory objects. By default draft versions are used instead of deployed or released versions. If no draft version exists then the latest deployed or released version is used.

-------------------------- EXAMPLE 2 --------------------------

PS > Export-JS7InventoryItem -Folder /some_folder -FilePath /tmp/export.tar.gz -ArchiveFormat TAR.GZ

Exports any objects from the given folder to a compressed tar file.

-------------------------- EXAMPLE 3 --------------------------

PS > Export-JS7InventoryItem -Folder /some_folder -Deployable -FilePath /tmp/export.zip -ForSigning

Exports deployable objects only from the given folder to a zipped file that is used for signing. After signing and adding the signature files to the export archive then this archive can be imported and deployed in a JOC Cockpit instance operated for security level "high".

-------------------------- EXAMPLE 4 --------------------------

PS > Export-JS7InventoryItem -Path /some_folder/some_workflow -Type WORKFLOW -FilePath /tmp/export.zip

Exports the specified workflow from the indcated path to a zipped file. Use of the -Path parameter requires to specify the -Type parameter for the object type. Depending on availability the draft version or the latest deployed version of the workflow is used. If a draft version is available then it is eligible for export independent from the fact that the draft is valid or invalid.

-------------------------- EXAMPLE 5 --------------------------

PS > Export-JS7InventoryItem -Path /some_folder/some_workflow -Type WORKFLOW -Valid -FilePath /tmp/export.zip

Exports the specified workflow from the indcated path to a zipped file. Use of the -Path parameter requires to specify the -Type parameter for the object type. Depending on availability the draft version or the latest deployed version of the workflow is used. A draft version is considered only if it is valid otherwise the deployed version is used.

-------------------------- EXAMPLE 6 --------------------------

PS > Export-JS7InventoryItem -Folder /some_folder -Deployable -File /tmp/export.zip

Exports any deployable inventory objects such as workflows, junctions, locks etc that are available from the specified folder to a zipped file. The latest deployed version of the workflow is used.