# Commandlets

```{toctree}
:glob: true
:hidden: true

commandlets/objects
commandlets/show-bomwindow
commandlets/*
```

All Commandlets are supporting OData Version v1, v2, v3, v4.

The cmdlets try to perform as less server requests as possible, in order to ensure high performance. when communicating over the network or the internet.

```{admonition} Metadata
This means that metadata such as the service metadata will be retrieved only when required and only for the required services.\
When services are not available, powerGate will try to retrieve there metadata as long, as they become available! Warning will be logged in order to inform the user about the downtime of the server.

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

## Connection

Connection related cmdlets.

| Name                                          | Description                    |
|-----------------------------------------------|--------------------------------|
| [Connect-ERP](commandlets/connect-erp)        | Connects to a ERP-System.      |
| [Disconnect-ERP](commandlets/disconnect-erp)  | Disconnects from a ERP-System. |


## Metadata

Cmdlets to read metadata from the services.

| Name                                                  | Description                                          |
|-------------------------------------------------------|------------------------------------------------------|
| [Get-ERPServices](commandlets/get-erpservices)        | Returns information about the connected services     |
| [Get-ERPEntitySets](commandlets/get-erpentitysets)    | Returns information about the available entitySets   |
| [Get-ERPEntityTypes](commandlets/get-erpentitytypes)  | Returns information about the available EntityTypes. |


## Entities

Cmdlets for reading, adding, updating and removing entities.

| Name                                              | Description                                                                 |
|---------------------------------------------------|-----------------------------------------------------------------------------|
| [Get-ERPObject](commandlets/get-erpobject)        | Returns a specific entity from the ERP-System.                              |
| [Get-ERPObjects](commandlets/get-erpobjects)      | Searches for entities depending on the passed arguments.                    |
| [Update-ERPObject](commandlets/update-erpobject)  | Updates an existing entity on the ERP-System.                               |
| [Add-ERPObject](commandlets/add-erpobject)        | Creates a new entity and transfers it to a ERP-System.                      |
| [Remove-ERPObject](commandlets/remove-erpobject)  | Deletes a specific entity from the ERP-System.                              |
| [New-ERPObject](commandlets/new-erpobject)        | Create a new and empty instance of the required entity from the ERP-System. |


## Media

Cmdlets for downloading, uploading and updating media (e.g Files...).

| Name                                            | Description                                        |
|-------------------------------------------------|----------------------------------------------------|
| [Add-ERPMedia](commandlets/add-erpmedia)        | Uploads media (e.g Files..) to the ERP-System.     |
| [Get-ERPMedia](commandlets/get-erpmedia)        | Downloads media (e.g Files..) from the ERP-System. |
| [Update-ERPMedia](commandlets/update-erpmedia)  | Updates media on the ERP-System.                   |