> ## 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)

> Utilisez la CLI PowerShell GoreloAction pour générer des alertes et écrire dans des champs personnalisés d'actif à partir de vos scripts, avec les paramètres de gravité, de nom et de suppression.

GoreloAction est un utilitaire en ligne de commande qui permet aux scripts PowerShell d'interagir avec Gorelo. Il prend actuellement en charge :

* La génération d'alertes.
* L'écriture dans des champs personnalisés d'actif.

## Utiliser GoreloAction

<Tabs>
  <Tab title="Générer des alertes">
    Exécutez la commande suivante dans votre terminal, et remplacez `<String>` par les valeurs des paramètres :

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

    ### Paramètres

    | Option         | Description                                                                                                       |
    | -------------- | ----------------------------------------------------------------------------------------------------------------- |
    | `-Alert`       | Spécifie le mode de création d'alerte.                                                                            |
    | `-Severity`    | Définit le niveau de gravité (entier) <ul><li>1 : Critique</li><li>2 : Erreur</li><li>3 : Avertissement</li></ul> |
    | `-Name`        | Titre/nom de l'alerte dans Gorelo.                                                                                |
    | `-Description` | Description détaillée de l'alerte dans Gorelo (facultatif).                                                       |
    | `-Suppress`    | Durée de suppression de l'alerte en heures (facultatif et par défaut à 4, utilisez 0 pour aucune suppression).    |
    |                |                                                                                                                   |

    #### Exemple

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

  <Tab title="Écrire dans un champ personnalisé d'actif">
    Exécutez la commande suivante dans votre terminal, et remplacez `<String>` par les valeurs des paramètres :

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

    #### Paramètres

    | Option            | Description                                                                                                     |
    | ----------------- | --------------------------------------------------------------------------------------------------------------- |
    | `-SetCustomField` | Spécifie le mode d'écriture dans un champ personnalisé.                                                         |
    | `-Name`           | Identifiant du champ : <ul><li>Format : `'asset.fieldname'`</li><li>Retirez `$gorelo`: de la variable</li></ul> |
    | `-Value`          | Données à stocker dans le champ.                                                                                |

    #### Exemple

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