[comment]: # translation:outdated

[comment]: # ({cd91b3fe-cd91b3fe})
# script.get

[comment]: # ({/cd91b3fe-cd91b3fe})

[comment]: # ({96ec37bc-96ec37bc})
### תיאור

`integer/array script.get(object parameters)`

השיטה מאפשרת לאחזר סקריפטים לפי הפרמטרים הנתונים.

::: noteclassic
שיטה זו זמינה למשתמשים מכל סוג. הרשאות
כדי לקרוא את השיטה ניתן לבטל בהגדרות תפקיד המשתמש. ראה [משתמש
תפקידים](/manual/web_interface/frontend_sections/administration/user_roles)
למידע נוסף.
:::

[comment]: # ({/96ec37bc-96ec37bc})

[comment]: # ({12625b94-c425a65a})
### פרמטרים

`(object)` פרמטרים המגדירים את הפלט הרצוי.

השיטה תומכת בפרמטרים הבאים.

|פרמטר|[סוג](/manual/api/reference_commentary#data_types)|תיאור|
|--|--|------|
|groupids|string/array|החזר רק סקריפטים שניתן להפעיל בקבוצות המארחות הנתונות.|
|hostids|string/array|החזר רק סקריפטים שניתן להפעיל על המארחים הנתונים.|
|scriptids|string/array|החזר רק סקריפטים עם המזהים הנתונים.|
|usrgrpids|string/array|החזר רק סקריפטים שיכולים להיות מופעלים על ידי משתמשים בקבוצות המשתמשים הנתונות.|
|selectGroups|query|החזר מאפיין [groups](/manual/api/reference/hostgroup/object) עם קבוצות מארח שעליהן ניתן להפעיל את הסקריפט.|
|selectHosts|query|החזר מאפיין [hosts](/manual/api/reference/host/object) עם מארחים שעליהם ניתן להפעיל את הסקריפט.|
|selectActions|query|החזר מאפיין [actions](/manual/api/reference/action/object) עם פעולות שהסקריפט משויך אליהן.|
|sortfield|string/array|מיין את התוצאה לפי המאפיינים הנתונים.<br><br>ערכים אפשריים הם: `scriptid` ו`name`.|
|countOutput|boolean|הפרמטרים הללו, המשותפים לכל שיטות ה-'get', מתוארים בפירוט ב[פירוש ההתייחסות](/manual/api/reference_commentary#common_get_method_parameters).|
|עריכה|בוליאנית|^|
|excludeSearch|בולאני|^|
|filter|object|^|
|limit|מספר שלם|^|
|פלט|שאילתה|^|
|preservekeys|בולאני|^|
|חיפוש|אובייקט|^|
|searchByAny|boolean|^|
|searchWildcardsEnabled|בוליאני|^|
|sortorder|מחרוזת/מערך|^|
|startSearch|boolean|^|

[comment]: # ({/12625b94-c425a65a})

[comment]: # ({7223bab1-7223bab1})
### החזר ערכים

`(מספר שלם/מערך)` מחזיר אחד:

- מערך של חפצים;
- ספירת האובייקטים שאוחזרו, אם יש לפרמטר `countOutput`
     נעשה שימוש.

[comment]: # ({/7223bab1-7223bab1})

[comment]: # ({b41637d2-b41637d2})
### דוגמאות

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({59acc8d9-6d428f32})
### החזר ערכים

`(מספר שלם/מערך)` מחזיר אחד:

- מערך של חפצים;
- ספירת האובייקטים שאוחזרו, אם יש לפרמטר `countOutput`
      נעשה שימוש.

[comment]: # ({/59acc8d9-6d428f32})

[comment]: # ({b0b740ec-b0b740ec})
### מידע נוסף

-   [מארח](/manual/api/reference/host/object#object_details)
-   [קבוצת מארחים](/manual/api/reference/hostgroup/object#object_details)

[comment]: # ({/b0b740ec-b0b740ec})

[comment]: # ({90dfc753-90dfc753})
### מקור

CScript::get()‎ בתוך *ui/include/classes/api/services/CScript.php*.

[comment]: # ({/90dfc753-90dfc753})