مشاركة عبر

الحصول على نشاط معالجة واحد بواسطة المعرّف

  • مقالة

ينطبق على:

هل تريد تجربة Defender لنقطة النهاية؟ اشترك للحصول على نسخة تجريبية مجانية.

هل تريد تجربة إدارة الثغرات الأمنية في Microsoft Defender؟ تعرف على المزيد حول كيفية التسجيل في إدارة الثغرات الأمنية في Microsoft Defender الإصدار التجريبي للمعاينة العامة.

هام

تتعلق بعض المعلومات الواردة في هذه المقالة بالناتج الذي تم إصداره مسبقًا والذي قد يتم تعديله بشكل كبير قبل إصداره تجاريًا. لا تقدم 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

وصف واجهة برمجة التطبيقات

إرجاع معلومات لنشاط المعالجة المحدد. يقدم نفس الأعمدة مثل الحصول على جميع نشاط المعالجة"، ولكنه يرجع النتائج لنشاط المعالجة المحدد فقط.

تعرف على المزيد حول أنشطة المعالجة.

سرد نشاط معالجة محدد ل (المعرف)

Url: GET: /api/remediationTasks/{id}

الأذونات

أحد الأذونات التالية مطلوب لاستدعاء واجهة برمجة التطبيقات هذه. لمعرفة المزيد، بما في ذلك كيفية اختيار الأذونات، راجع استخدام واجهات برمجة التطبيقات Microsoft Defender لنقطة النهاية للحصول على التفاصيل.

نوع الإذن اذن اسم عرض الإذن
Application RemediationTasks.Read.All "قراءة معلومات الثغرات الأمنية لإدارة المخاطر والثغرات الأمنية"
مفوض (حساب العمل أو المؤسسة التعليمية) RemediationTask.Read.Read "قراءة معلومات الثغرات الأمنية لإدارة المخاطر والثغرات الأمنية"

خصائص

الخاصية (المعرف) نوع البيانات الوصف مثال على قيمة تم إرجاعها
الفئة سلسلة فئة نشاط المعالجة (تكوين البرنامج/الأمان) البرامج
completerEmail سلسلة إذا تم إكمال نشاط المعالجة يدويا من قبل شخص ما، فإن هذا العمود يحتوي على بريده الإلكتروني فارغه
معرف المكتمل سلسلة إذا تم إكمال نشاط المعالجة يدويا بواسطة شخص ما، فإن هذا العمود يحتوي على معرف الكائن الخاص به فارغه
completeMethod سلسلة يمكن إكمال نشاط المعالجة "تلقائيا" (إذا تم تصحيح جميع الأجهزة) أو "يدويا" من قبل شخص يحدد "وضع علامة كمكتملة" تلقائي
createdOn Datetime وقت إنشاء نشاط المعالجة هذا 2021-01-12T18:54:11.5499478Z
الوصف سلسلة وصف نشاط المعالجة هذا قم بتحديث Microsoft Silverlight إلى إصدار أحدث للتخفيف من الثغرات الأمنية المعروفة التي تؤثر على أجهزتك.
dueOn Datetime تاريخ الاستحقاق الذي حدده المنشئ لنشاط المعالجة هذا 2021-01-13T00:00:00Z
الأجهزة الثابتة عدد الأجهزة التي تم إصلاحها 2
المعرّف سلسلة معرف نشاط المعالجة هذا 097d9735-5479-4899-b1b7-77398899df92
معرف الاسم سلسلة اسم المنتج ذي الصلة Microsoft Silverlight
الاولويه سلسلة الأولوية التي تم تعيينها للمنشئ لنشاط المعالجة هذا (High\Medium\Low) عاليه
Productid سلسلة معرف المنتج ذي الصلة microsoft-_-silverlight
productivityImpactRemediationType سلسلة يمكن طلب بعض تغييرات التكوين فقط للأجهزة التي لا تؤثر على المستخدمين. تشير هذه القيمة إلى التحديد بين "جميع الأجهزة المكشوفة" أو "الأجهزة التي ليس لها تأثير على المستخدم فقط". AllExposedAssets
أسماء rbacGroup سلسلة أسماء مجموعات الأجهزة ذات الصلة [ "خوادم Windows"، "Windows 11"، "Windows 10" ]
البرنامج الموصى به سلسلة البرنامج الموصى به للترقية إلى فارغه
موصى به سلسلة المورد الموصى به للترقية إلى فارغه
إصدار مستحسن سلسلة الإصدار الموصى به للتحديث/الترقية إلى فارغه
الحوسبة ذات الصلة سلسلة المكون ذي الصلة لنشاط المعالجة هذا (على غرار المكون ذي الصلة لتوصية الأمان) Microsoft Silverlight
requesterEmail سلسلة عنوان البريد الإلكتروني الخاص بالمبدعين globaladmin@UserName.contoso.com
معرف الطالب سلسلة معرف كائن المنشئ r647211f-2e16-43f2-a480-16ar3a2a796r
مقدم الطلبNotes سلسلة الملاحظات (النص الحر) التي أضافها المنشئ لنشاط المعالجة هذا فارغه
Scid سلسلة SCID من توصية الأمان ذات الصلة فارغه
حاله سلسلة حالة نشاط المعالجة (نشط/مكتمل) النشطه
statusLastModifiedOn Datetime تاريخ تحديث حقل الحالة 2021-01-12T18:54:11.5499487Z
الأجهزة المستهدفة طويله عدد الأجهزة المكشوفة التي ينطبق عليها هذا المعالجة 43
عنوان سلسلة عنوان نشاط المعالجة هذا 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
}

راجع أيضًا

تلميح

هل تريد معرفة المزيد؟ Engage مع مجتمع أمان Microsoft في مجتمعنا التقني: Microsoft Defender لنقطة النهاية Tech Community.