שתף באמצעות

פרט את כל פעילויות התיקון

  • מאמר

חל על:

רוצה להתנסות ב- Microsoft Defender עבור נקודת קצה? הירשם לקבלת גירסת ניסיון ללא תשלום.

רוצה לחוות את ניהול פגיעויות של Microsoft Defender? קבל מידע נוסף על האופן שבו תוכל להירשם לניסיון של ניהול פגיעויות של Microsoft Defender Public Preview.

חשוב

חלק מהמידע במאמר זה מתייחס למוצר שהופץ מראש, אשר עשוי להיות שונה באופן משמעותי לפני ההפצה המסחרית שלו. Microsoft אינה מעניקה כל אחריות, מפורשת או משתמעת, ביחס למידע המסופק כאן.

הערה

אם אתה לקוח של ממשלת ארה"ב, השתמש בURI המפורטים ב- Microsoft Defender עבור נקודת קצה עבור לקוחות של ממשלת ארה"ב.

עצה

לקבלת ביצועים טובים יותר, באפשרותך להשתמש בשרת קרוב יותר למיקום הגיאוגרפי שלך:

  • 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

תיאור API

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

קבל מידע נוסף על פעילויות תיקון.

כתובת url: קבל: /api/תיקוןפעילויות
תומך בשאילתות OData V4.
אופרטורים נתמכים של OData:
$filter on: createdon ו status - properties.
$top עם הערך המרבי של 10,000.
$skip.
ראה דוגמאות בשאילתות OData עם Microsoft Defender עבור נקודת קצה.

הרשאות

אחת מההרשאות הבאות נדרשת כדי לקרוא ל- API זה. לקבלת מידע נוסף, כולל אופן בחירת הרשאות, ראה שימוש בממשקי MICROSOFT DEFENDER עבור נקודת קצה API לקבלת פרטים.

סוג הרשאה הרשאה שם תצוגה של הרשאה
יישום תיקוןTasks.Read.All 'קרא מידע על פגיעות של ניהול איומים ופגיעות'
מוסמך (חשבון בעבודה או בבית ספר) RemediationTask.Read 'קרא מידע על פגיעות של ניהול איומים ופגיעות'

מאפייני

מאפיין (מזהה) סוג נתונים תיאור דוגמה של ערך מוחזר
קטגוריה מחרוזת קטגוריית פעילות התיקון (תצורת תוכנה/אבטחה) תוכנה
completerEmail מחרוזת אם פעילות התיקון הושלמה באופן ידני על-ידי מישהו, עמודה זו מכילה את הדואר האלקטרוני שלו Null
מזהה מלא מחרוזת אם פעילות התיקון הושלמה באופן ידני על-ידי מישהו, עמודה זו מכילה את מזהה האובייקט שלו Null
completionMethod מחרוזת ניתן להשלים פעילות תיקון "באופן אוטומטי" (אם כל המכשירים תותקנו) או "באופן ידני" על-ידי אדם שבחר באפשרות "סמן כמשימה שהושלמה" אוטומטי
נוצר על-ידי Datetime מועד היווצרות פעילות תיקון זו 2021-01-12T18:54:11.5499478Z
תיאור מחרוזת תיאור פעילות תיקון זו עדכן את Microsoft Silverlight לגירסה מתקדמת יותר כדי לצמצם פגיעויות ידועות שמשפיעות על המכשירים שלך.
תאריך יעד Datetime תאריך היעד של ערכת היוצרים עבור פעילות תיקון זו 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" ]
תוכניות מומלצות מחרוזת תוכנית מומלצת לשדרוג ל- Null
מומלץבדור מחרוזת ספק מומלץ לשדרוג ל- Null
מומלץהווריון מחרוזת גירסה מומלצת לעדכון/שדרוג ל- Null
קובץ קשורComponent מחרוזת רכיב קשור של פעילות תיקון זו (דומה לרכיב הקשור להמלצת אבטחה) Microsoft Silverlight
requesterEmail מחרוזת כתובת דואר אלקטרוני של יוצר globaladmin@UserName.contoso.com
מזהה בקשת מחרוזת מזהה אובייקט של יוצר r647211f-2e16-43f2-a480-16ar3a2a796r
הערות של מבקש מחרוזת ההערות (טקסט חופשי) שיצר הוסיף לפעילות תיקון זו Null
מזהה מזהה מחרוזת SCID של המלצת האבטחה הקשורה Null
Status מחרוזת מצב פעילות תיקון (פעיל/הושלם) פעילה
מצבLastModifiedOn Datetime תאריך העדכון של שדה המצב 2021-01-12T18:54:11.5499487Z
מכשירים ייעודיים זמן מספר המכשירים החשופים שתיקון זה ישים עבורם 43
Title מחרוזת הכותרת של פעילות תיקון זו עדכן את Microsoft Silverlight
סוג מחרוזת סוג תיקון עדכן
מזהה ספק מחרוזת שם ספק קשור Microsoft

דוגמה

דוגמה לבקשה

GET https://api.securitycenter.windows.com/api/remediationtasks/

דוגמה לתגובה

{
    "@odata.context": "https://api.securitycenter.windows.com/api/$metadata#RemediationTasks",
    "value": [
        {
            "id": "03942ef5-aewb-4w6e-b555-d6a97013844w",
            "title": "Update Microsoft Silverlight",
            "createdOn": "2021-02-10T13:20:36.4718166Z",
            "requesterId": "65548a1d-ef00-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
        }
    ]
}

למידע נוסף

עצה

האם ברצונך לקבל מידע נוסף? Engage עם קהילת האבטחה של Microsoft בקהילת הטכנולוגיה שלנו: Microsoft Defender עבור נקודת קצה Tech Community.