Cmdlets

This page provides a quick overview of all PowerShell cmdlets available with the powerGate installation. They enable the integration of Autodesk Vault with ERP, PLM and other Autodesk Platform Services (APS).

Depending on the installed components, the following modules are available:

Module	Purpose	Cmdlet documentation
powerGate	Integration with ERP systems through OData services	This page
powerAPS	Integration with Autodesk Platform Services (APS)	powerAPS Cmdlets
powerPLM	Integration with Autodesk Fusion Manage	powerPLM Cmdlets
powerJobs	Automations for document processing through Vault jobs	powerJobs Cmdlets
powerEvents	Automations, UI extensions, and guardrails for Vault Client, Inventor, and more.	powerEvents Cmdlets
powerVault	Automation of Vault files, items, change orders, and other Vault objects	powerVault Cmdlets

ERP Cmdlets

All ERP cmdlets support OData versions v1, v2, v3, and v4.
They all try to perform as less server requests as possible, in order to ensure high performance when communicating over the network or the internet with your ERP system.

Connection and service metadata

Cmdlets for connection establishment with OData services:

Name	Description
Connect-ERP	Connects to an ERP-System.
Disconnect-ERP	Disconnects from an ERP-System.

Cmdlets to read metadata of connected OData services:

Name	Description
Get-ERPServices	Returns information about the connected services
Get-ERPEntitySets	Returns information about the available entitySets
Get-ERPEntityTypes	Returns information about the available EntityTypes.

Metadata

Requests to retrieve the service $metadata are only performed when needed and only for the required services.
When services are not available, powerGate will try to retrieve there metadata as long as they become available! Warnings will be logged in order to inform about the downtime of the service.

After retrieving metadata once, no further metadata request is required as the server results are cached.

Performance

When some of the services are permanently not available, you can speed up your process by disconnecting them.
Please see example Disconnect all not available services.

---

The following Cmdlets require a successful connection between the current application and the ERP system or powerGateServer.
For them to work properly, all the necessary ERP services (or a single CatalogService) must have been previously connected by the Connect-ERP cmdlet.

Entity transfer

Cmdlets for reading, adding, updating and removing OData entities:

Name	Description
Get-ERPObject	Returns a specific entity from the ERP-System.
Get-ERPObjects	Searches for entities depending on the passed arguments.
Update-ERPObject	Updates an existing entity on the ERP-System.
Add-ERPObject	Creates a new entity and transfers it to a ERP-System.
Remove-ERPObject	Deletes a specific entity from the ERP-System.
New-ERPObject	Returns a new default instance of the desired ERP entity or complex type.
Invoke-ERPOperation	Invokes an OData action or function exposed by an ERP service.

Media exchange

Cmdlets for downloading, uploading and updating OData media files such as images, text files or even Autodesk file formats:

Name	Description
Add-ERPMedia	Uploads media files to the ERP-System.
Get-ERPMedia	Downloads media files from the ERP-System.
Update-ERPMedia	Updates media files on the ERP-System.

Additional Cmdlets for APS and PLM Integrations

The powerAPS module provides the following additional cmdlet for connecting to Autodesk Platform Services (APS).
Building on top of it, the powerPLM module provides specific cmdlets for integrating with Autodesk Fusion Manage.

Requirements

To use the cmdlets with your ACC and BIM 360 hubs, make sure that the systems are property provisioned.
For Fusion Manage, make sure that your tenant is configured correctly.

This includes whitelisting the required Client ID and assigning the necessary product access to your Autodesk ID’s.

Name	Description
Connect-APS	Authenticates via OAuth and connects to APS.
Connect-FLC	Connects to a Fusion Manage tenant.
Get-FLCItem	Retrieves items from an Fusion Manage workspace.
Add-FLCItem	Adds a new Item to a workspace in Fusion Manage.
Update-FLCItem	Updates properties and affected items and performs workflow actions on an existing Item in Fusion Manage.
Get-FLCItemAssociations	Retrieves Linked Items (or Managed Items) or Attachments for an Item in Fusion Manage.
Add-FLCAttachment	Adds an attachment to an existing Item in Fusion Manage.
Save-FLCAttachment	Downloads the specified attachment from Fusion Manage to a local path.
Name	Description
Get-FLCBOM	Retrieves the BOM of an FLC Item.
Update-FLCBOM	Manipulates the BOM of an existing Item in Fusion Manage.