[comment]: # ({084d9051-084d9051})
# עדכון משתמש

[comment]: # ({/084d9051-084d9051})

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

`object user.update(משתמשי אובייקט/מערך)`

שיטה זו מאפשרת לעדכן משתמשים קיימים.

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

::: noteclassic
עוצמת סיסמת המשתמש מאומתת בהתאם ל
כללי מדיניות סיסמאות שהוגדרו על ידי Authentication API. ראה [אימות
API](/manual/api/reference/authentication) למידע נוסף
מֵידָע.
:::

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

[comment]: # ({8ed69eee-3b478f18})
### פרמטרים

`(אובייקט/מערך)` יש לעדכן מאפייני משתמש.

יש להגדיר את המאפיין 'userid' עבור כל משתמש, כל השאר
נכסים הם אופציונליים. רק המאפיינים שעברו יעודכנו, כולם
אחרים יישארו ללא שינוי.

בנוסף ל[מאפייני משתמש סטנדרטיים](object#user), השיטה
מקבל את הפרמטרים הבאים.

|פרמטר|[סוג](/manual/api/reference_commentary#data_types)|תיאור|
|--|--|------|
|passwd|string|סיסמת המשתמש.<br><br>יכולה להיות מחרוזת ריקה אם המשתמש שייך או מועבר רק לקבוצות שיש להן גישת LDAP.|
|usrgrps|array|משתמש [קבוצות](/manual/api/reference/user/create) כדי להחליף קבוצות משתמשים קיימות.<br><br>על קבוצות המשתמשים להיות מוגדר המאפיין `usrgrpid`.|
|medias|array|[מדיה משתמש](/manual/api/reference/user/object#media) להחלפת מדיה קיימת.|
|user_medias<br>(הוצא משימוש)|מערך|פרמטר זה הוצא משימוש, אנא השתמש ב-'medias' במקום זאת.<br>משתמש [media](/manual/api/reference/user/object#media) כדי להחליף מדיה קיימת.|

[comment]: # ({/8ed69eee-3b478f18})

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

`(אובייקט)` מחזירה אובייקט המכיל את המזהים של המשתמשים המעודכנים
תחת המאפיין 'משתמשים'.

[comment]: # ({/4c3fb877-4c3fb877})

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

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

[comment]: # ({ca60eb4e-c0483e48})
#### שינוי שם של משתמש

שנה שם משתמש לג'ון דו.

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "user.update",
     "params": {
         "userid": "1",
         "name": "ג'ון",
         "surname": "איילה"
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

``` json
{
     "jsonrpc": "2.0",
     "תוצאה": {
         "משתמשים": [
             "1"
         ]
     },
     "מזהה": 1
}
```

[comment]: # ({/ca60eb4e-c0483e48})

[comment]: # ({2a24dd67-7ae4c491})
#### שינוי תפקיד משתמש

שנה תפקיד של משתמש.

בַּקָשָׁה:

``` json
{
     "jsonrpc": "2.0",
     "method": "user.update",
     "params": {
         "userid": "12",
         "roleid": "6"
     },
     "auth": "038e1d7b1735c6a5436ee9eae095879e",
     "מזהה": 1
}
```

תְגוּבָה:

``` json
{
     "jsonrpc": "2.0",
     "תוצאה": {
         "משתמשים": [
             "12"
         ]
     },
     "מזהה": 1
}
```

[comment]: # ({/2a24dd67-7ae4c491})

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

-   [אימות](/manual/api/reference/authentication)

[comment]: # ({/1083dc26-1083dc26})

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

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

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