קבל פעילות תיקון אחת לפי מזהה
חל על:
- Microsoft Defender עבור תוכנית 1 של נקודת קצה
- Microsoft Defender עבור נקודת קצה
- ניהול פגיעויות של Microsoft Defender
- Microsoft Defender XDR
רוצה להתנסות ב- Microsoft Defender עבור נקודת קצה? הירשם לקבלת גירסת ניסיון ללא תשלום.
רוצה להיתקל בניהול פגיעויות של Microsoft Defender? קבל מידע נוסף על האופן שבו תוכל להירשם לניסיון הציבורי של ניהול פגיעויות של Microsoft Defender Public Preview.
חשוב
חלק מהמידע במאמר זה מתייחס למוצר שהופץ מראש, אשר עשוי להיות שונה באופן משמעותי לפני ההפצה המסחרית שלו. Microsoft אינה מעניקה כל אחריות, מפורשת או משתמעת, ביחס למידע המסופק כאן.
הערה
אם אתה לקוח של ממשלת ארה"ב, השתמש בURI המפורטים ב - Microsoft Defender for Endpoint עבור לקוחות של ממשלת ארה"ב.
עצה
לקבלת ביצועים טובים יותר, באפשרותך להשתמש בשרת קרוב יותר למיקום הגיאוגרפי שלך:
- us.api.security.microsoft.com
- eu.api.security.microsoft.com
- uk.api.security.microsoft.com
- au.api.security.microsoft.com
- swa.api.security.microsoft.com
- ina.api.security.microsoft.com
תיאור API
מחזירה מידע עבור פעילות התיקון שצוינה. מציג את אותן עמודות כמו קבל את כל פעילות התיקון", אך מחזיר תוצאות רק עבור פעילות התיקון שצוינה.
קבל מידע נוסף על פעילויות תיקון.
ציין פעילות תיקון שצוינה עבור (מזהה)
כתובת URL: GET: /api/remediationTasks/{id}
הרשאות
אחת מההרשאות הבאות נדרשת כדי לקרוא ל- API זה. לקבלת מידע נוסף, כולל כיצד לבחור הרשאות, ראה שימוש בממשקי API של Microsoft Defender for Endpoint לקבלת פרטים.
סוג הרשאה | הרשאה | שם תצוגה של הרשאה |
---|---|---|
יישום | תיקוןTasks.Read.All | 'קרא מידע על פגיעות של ניהול איומים ופגיעות' |
מוסמך (חשבון בעבודה או בבית ספר) | RemediationTask.Read.Read | 'קרא מידע על פגיעות של ניהול איומים ופגיעות' |
מאפיינים
מאפיין (מזהה) | סוג נתונים | תיאור | דוגמה של ערך מוחזר |
---|---|---|---|
קטגוריה | מחרוזת | קטגוריית פעילות התיקון (תצורת תוכנה/אבטחה) | תוכנה |
completerEmail | מחרוזת | אם פעילות התיקון הושלמה באופן ידני על-ידי מישהו, עמודה זו מכילה את הדואר האלקטרוני שלו | אֶפֶס |
מזהה מלא | מחרוזת | אם פעילות התיקון הושלמה באופן ידני על-ידי מישהו, עמודה זו מכילה את מזהה האובייקט שלו | אֶפֶס |
completionMethod | מחרוזת | ניתן להשלים פעילות תיקון "באופן אוטומטי" (אם כל המכשירים תותקנו) או "באופן ידני" על-ידי אדם שבחר באפשרות "סמן כמשימה שהושלמה" | אוטומטי |
נוצר על-ידי | תאריך ושעה | מועד היווצרות פעילות תיקון זו | 2021-01-12T18:54:11.5499478Z |
תיאור | מחרוזת | תיאור פעילות תיקון זו | עדכן את Microsoft Silverlight לגירסה מתקדמת יותר כדי לצמצם פגיעויות ידועות שמשפיעות על המכשירים שלך. |
תאריך יעד | תאריך ושעה | תאריך היעד של ערכת היוצרים עבור פעילות תיקון זו | 2021-01-13T00:00:00Z |
מכשירים קבועים | מספר המכשירים שתוקנו | 2 | |
ID | מחרוזת | מזהה פעילות תיקון זו | 097d9735-5479-4899-b1b7-77398899df92 |
מזהה שם | מחרוזת | שם מוצר קשור | Microsoft Silverlight |
Priority | מחרוזת | עדיפות ערכת היוצרים עבור פעילות תיקון זו (גבוהה\בינונית\נמוכה) | גבוהה |
מזהה מוצר | מחרוזת | מזהה מוצר קשור | microsoft-_-silverlight |
productivityImpactRemediationType | מחרוזת | ניתן לבקש מספר שינויי תצורה רק עבור מכשירים שאינם משפיעים על המשתמשים. ערך זה מציין את הבחירה בין "כל המכשירים החשופים" או "רק מכשירים ללא השפעה על המשתמש". | כל ההקצאות הנבחרות |
rbacGroupNames | מחרוזת | שמות של קבוצות מכשירים קשורים | [ "Windows Servers", "Windows 11", "Windows 10" ] |
תוכניות מומלצות | מחרוזת | תוכנית מומלצת לשדרוג ל- | אֶפֶס |
מומלץבדור | מחרוזת | ספק מומלץ לשדרוג ל- | אֶפֶס |
מומלץהווריון | מחרוזת | גירסה מומלצת לעדכון/שדרוג ל- | אֶפֶס |
קובץ קשורComponent | מחרוזת | רכיב קשור של פעילות תיקון זו (דומה לרכיב הקשור להמלצת אבטחה) | Microsoft Silverlight |
requesterEmail | מחרוזת | כתובת דואר אלקטרוני של יוצר | globaladmin@UserName.contoso.com |
מזהה בקשת | מחרוזת | מזהה אובייקט של יוצר | r647211f-2e16-43f2-a480-16ar3a2a796r |
הערות של מבקש | מחרוזת | ההערות (טקסט חופשי) שיצר הוסיף לפעילות תיקון זו | אֶפֶס |
מזהה מזהה | מחרוזת | SCID של המלצת האבטחה הקשורה | אֶפֶס |
Status | מחרוזת | מצב פעילות תיקון (פעיל/הושלם) | פעילה |
מצבLastModifiedOn | תאריך ושעה | תאריך העדכון של שדה המצב | 2021-01-12T18:54:11.5499487Z |
מכשירים ייעודיים | ארוך | מספר המכשירים החשופים שתיקון זה ישים עבורם | 43 |
Title | מחרוזת | הכותרת של פעילות תיקון זו | Microsoft Silverlight |
סוג | מחרוזת | סוג תיקון | עדכן |
מזהה ספק | מחרוזת | שם ספק קשור | Microsoft |
דוגמה
דוגמה לבקשה
GET https://api.securitycenter.windows.com/api/remediationtasks/03942ef5-aecb-4c6e-b555-d6a97013844c
דוגמה לתגובה
{
"@odata.context": "https://api.securitycenter.windows.com/api/$metadata#RemediationTasks/$entity",
"id": "03942ef5-aecb-4c6e-b555-d6a97013844c",
"title": "Update Microsoft Silverlight",
"createdOn": "2021-02-10T13:20:36.4718166Z",
"requesterId": "65548a1d-efo0-4a7a-8d19-1b967b5c36f4",
"requesterEmail": "user1@contoso.com",
"status": "Active",
"statusLastModifiedOn": "2021-02-10T13:20:36.4719698Z",
"description": "Update Silverlight to a later version to mitigate 55 known vulnerabilities affecting your devices. Doing so can help lessen the security risk to your organization due to versions which have reached their end-of-support.",
"relatedComponent": "Microsoft Silverlight",
"targetDevices": 18511,
"rbacGroupNames": [
"UnassignedGroup",
"hhh"
],
"fixedDevices": 2866,
"requesterNotes": "test",
"dueOn": "2021-02-11T00:00:00Z",
"category": "Software",
"productivityImpactRemediationType": null,
"priority": "Medium",
"completionMethod": null,
"completerId": null,
"completerEmail": null,
"scid": null,
"type": "Update",
"productId": "microsoft-_-silverlight",
"vendorId": "microsoft",
"nameId": "silverlight",
"recommendedVersion": null,
"recommendedVendor": null,
"recommendedProgram": null
}
למידע נוסף
- פעולות שירות ומאפיינים של תיקון
- פרט את כל פעילויות התיקון
- פרט מכשירים חשופים של פעילות תיקון אחת
- ניהול פגיעויות של Microsoft Defender
- פגיעויות בארגון שלך
עצה
האם ברצונך לקבל מידע נוסף? צור קשר עם קהילת האבטחה של Microsoft בקהילה הטכנית שלנו: Microsoft Defender for Endpoint Tech Community.