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

# GoreloAction CLI (عبر PowerShell)

> استخدم واجهة سطر الأوامر GoreloAction في PowerShell لإنشاء التنبيهات والكتابة إلى حقول الأصول المخصصة من نصوصك البرمجية، مع معاملات للخطورة والاسم والكتم.

GoreloAction هي أداة سطر أوامر تتيح لنصوص PowerShell التفاعل مع Gorelo. وهي تدعم حاليًا:

* إنشاء التنبيهات.
* الكتابة إلى حقول الأصول المخصصة.

## استخدام GoreloAction

<Tabs>
  <Tab title="إنشاء التنبيهات">
    شغّل الأمر التالي في الطرفية الخاصة بك، واستبدل `<String>` بقيم المعاملات:

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

    ### المعاملات

    | الخيار         | الوصف                                                                                  |
    | -------------- | -------------------------------------------------------------------------------------- |
    | `-Alert`       | يحدد وضع إنشاء التنبيه.                                                                |
    | `-Severity`    | يحدد مستوى الخطورة (عدد صحيح) <ul><li>1: حرج</li><li>2: خطأ</li><li>3: تحذير</li></ul> |
    | `-Name`        | عنوان/اسم التنبيه في Gorelo.                                                           |
    | `-Description` | وصف مفصل للتنبيه في Gorelo (اختياري).                                                  |
    | `-Suppress`    | مدة كتم التنبيه بالساعات (اختياري وافتراضيًا 4، استخدم 0 لعدم الكتم).                  |
    |                |                                                                                        |

    #### مثال

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

  <Tab title="الكتابة إلى حقل أصل مخصص">
    شغّل الأمر التالي في الطرفية الخاصة بك، واستبدل `<String>` بقيم المعاملات:

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

    #### المعاملات

    | الخيار            | الوصف                                                                                         |
    | ----------------- | --------------------------------------------------------------------------------------------- |
    | `-SetCustomField` | يحدد وضع الكتابة إلى الحقل المخصص.                                                            |
    | `-Name`           | معرّف الحقل: <ul><li>التنسيق: `'asset.fieldname'`</li><li>أزل `$gorelo`: من المتغير</li></ul> |
    | `-Value`          | البيانات المراد تخزينها في الحقل.                                                             |

    #### مثال

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