שתף באמצעות

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

  • מאמר

חל על:

רוצה להתנסות ב- 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: קבל: /api/תיקוןפעילויות
תומך בשאילתות OData V4.
אופרטורים נתמכים של OData:
$filter on: createdon ו status - properties.
$top עם הערך המרבי של 10,000.
$skip.
ראה דוגמאות בשאילתות OData עם Microsoft Defender for Endpoint.

הרשאות

אחת מההרשאות הבאות נדרשת כדי לקרוא ל- API זה. לקבלת מידע נוסף, כולל כיצד לבחור הרשאות, ראה שימוש בממשקי API של Microsoft Defender for Endpoint לקבלת פרטים.

סוג הרשאה הרשאה שם תצוגה של הרשאה
יישום תיקוןTasks.Read.All 'קרא מידע על פגיעות של ניהול איומים ופגיעות'
מוסמך (חשבון בעבודה או בבית ספר) RemediationTask.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/

דוגמה לתגובה

{
    "@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
        }
    ]
}

למידע נוסף

עצה

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