> ## Documentation Index
> Fetch the complete documentation index at: https://help.gorelo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI GoreloAction (via PowerShell)

> Utilitzeu la CLI GoreloAction de PowerShell per generar alertes i escriure a camps personalitzats d'actiu des dels vostres scripts, amb paràmetres de gravetat, nom i supressió.

GoreloAction és una utilitat de línia d'ordres que permet als scripts de PowerShell interactuar amb Gorelo. Actualment admet:

* Generar alertes.
* Escriure a camps personalitzats d'actiu.

## Utilitzar GoreloAction

<Tabs>
  <Tab title="Generar alertes">
    Executeu l'ordre següent al vostre terminal i reemplaceu `<String>` pels valors dels paràmetres:

    ```powershell theme={null}
    GoreloAction -Alert -Severity <Int> -Name <String> -Description <String> -Suppress <Int>
    ```

    ### Paràmetres

    | Opció          | Descripció                                                                                               |
    | -------------- | -------------------------------------------------------------------------------------------------------- |
    | `-Alert`       | Especifica el mode de creació d'alerta.                                                                  |
    | `-Severity`    | Estableix el nivell de gravetat (enter) <ul><li>1: Crític</li><li>2: Error</li><li>3: Avís</li></ul>     |
    | `-Name`        | Títol/nom de l'alerta a Gorelo.                                                                          |
    | `-Description` | Descripció detallada de l'alerta a Gorelo (opcional).                                                    |
    | `-Suppress`    | Durada de la supressió de l'alerta en hores (opcional i per defecte 4, utilitzeu 0 per a cap supressió). |
    |                |                                                                                                          |

    #### Exemple

    ```powershell theme={null}
    GoreloAction -Alert -Severity 1 -Name "NameHere" -Description "DescriptionHere" -Suppress 0
    ```
  </Tab>

  <Tab title="Escriure a camp personalitzat d'actiu">
    Executeu l'ordre següent al vostre terminal i reemplaceu `<String>` pels valors dels paràmetres:

    ```powershell theme={null}
    GoreloAction -SetCustomField -Name <String> -Value <String>
    ```

    #### Paràmetres

    | Opció             | Descripció                                                                                                       |
    | ----------------- | ---------------------------------------------------------------------------------------------------------------- |
    | `-SetCustomField` | Especifica el mode d'escriptura de camp personalitzat.                                                           |
    | `-Name`           | Identificador del camp: <ul><li>Format: `'asset.fieldname'`</li><li>Elimineu `$gorelo`: de la variable</li></ul> |
    | `-Value`          | Dades que es desaran al camp.                                                                                    |

    #### Exemple

    ```powershell theme={null}
    GoreloAction -SetCustomField -Name 'asset.rustdeskPassword' -Value "SecurePassword123"
    ```
  </Tab>
</Tabs>