Tüm düzeltme etkinliklerini listele

Makale
05/03/2024

Şunlar için geçerlidir:

Uç Nokta için Microsoft Defender'ı deneyimlemek ister misiniz? Ücretsiz deneme için kaydolun..

Microsoft Defender Güvenlik Açığı Yönetimi mı yaşamak istiyorsunuz? Microsoft Defender Güvenlik Açığı Yönetimi genel önizleme denemesine nasıl kaydolabileceğiniz hakkında daha fazla bilgi edinin.

Önemli

Bu makaledeki bazı bilgiler önceden yayımlanmış bir ürünle ilgilidir ve ticari olarak piyasaya sürülmeden önce önemli ölçüde değiştirilmiş olabilir. Microsoft, burada sağlanan bilgilerle ilgili olarak açık veya zımni hiçbir garanti vermez.

Not

ABD Kamu müşterisiyseniz lütfen US Government müşterileri için Uç Nokta için Microsoft Defender'de listelenen URI'leri kullanın.

İpucu

Daha iyi performans için coğrafi konumunuza daha yakın olan sunucuyu kullanabilirsiniz:

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 açıklaması

Tüm düzeltme etkinlikleri hakkındaki bilgileri döndürür.

Düzeltme etkinlikleri hakkında daha fazla bilgi edinin.

URL: GET: /api/remediationTasks
OData V4 sorgularını destekler.
OData tarafından desteklenen işleçler:
$filter üzerinde: createdon ve status özellikleri.
$top 10.000 maksimum değere sahip.
$skip.
Uç Nokta için Microsoft Defender ile OData sorgularında örneklere bakın.

İzinler

Bu API'yi çağırmak için aşağıdaki izinlerden biri gereklidir. İzinlerin nasıl seçileceği de dahil olmak üzere daha fazla bilgi edinmek için ayrıntılar için bkz. Uç Nokta için Microsoft Defender API'lerini kullanma.

İzin türü	İzin	İzin görünen adı
Uygulama	RemediationTasks.Read.All	'Tehdit ve Güvenlik Açığı Yönetimi güvenlik açığı bilgilerini okuyun'
Temsilci (iş veya okul hesabı)	RemediationTask.Read	'Tehdit ve Güvenlik Açığı Yönetimi güvenlik açığı bilgilerini okuyun'

Özellikler

Özellik (Kimlik)	Veri türü	Açıklama	Döndürülen değer örneği
Kategori	Dize	Düzeltme etkinliğinin kategorisi (Yazılım/Güvenlik yapılandırması)	Yazılım
completerEmail	Dize	Düzeltme etkinliği bir kişi tarafından el ile tamamlandıysa, bu sütun kendi e-postasını içerir	Null
completerId	Dize	Düzeltme etkinliği birisi tarafından el ile tamamlandıysa, bu sütun nesne kimliğini içerir	Null
completionMethod	Dize	Bir düzeltme etkinliği "otomatik olarak" (tüm cihazlara düzeltme eki uygulandıysa) veya "tamamlandı olarak işaretle" seçeneğini seçen bir kişi tarafından "el ile" tamamlanabilir	Otomatik
createdOn	Datetime	Bu düzeltme etkinliğinin oluşturulduğu saat	2021-01-12T18:54:11.5499478Z
Açıklama	Dize	Bu düzeltme etkinliğinin açıklaması	Cihazlarınızı etkileyen bilinen güvenlik açıklarını azaltmak için Microsoft Silverlight'ı daha sonraki bir sürüme güncelleştirin.
dueOn	Datetime	Bu düzeltme etkinliği için oluşturanın ayarlandığı son tarih	2021-01-13T00:00:00Z
fixedDevices	.	Düzeltilmiş cihaz sayısı	2
Kimlik	Dize	Bu düzeltme etkinliğinin kimliği	097d9735-5479-4899-b1b7-77398899df92
nameId	Dize	İlgili ürün adı	Microsoft Silverlight
Öncelik	Dize	Bu düzeltme etkinliği için oluşturucu kümesinin önceliği (Yüksek\Orta\Düşük)	Yüksek
Productıd	Dize	İlgili ürün kimliği	microsoft-_-silverlight
productivityImpactRemediationType	Dize	Yalnızca kullanıcıları etkilemeyen cihazlar için birkaç yapılandırma değişikliği istenebilir. Bu değer, "kullanıma sunulan tüm cihazlar" veya "yalnızca kullanıcı etkisi olmayan cihazlar" arasındaki seçimi gösterir.	AllExposedAssets
rbacGroupNames	Dize	İlgili cihaz grubu adları	[ "Windows Sunucuları", "Windows 11", "Windows 10" ]
önerilenProgram	Dize	Yükseltme için önerilen program	Null
önerilenVendor	Dize	Yükseltmesi önerilen satıcı	Null
recommendedVersion	Dize	Güncelleştirme/yükseltme için önerilen sürüm	Null
relatedComponent	Dize	Bu düzeltme etkinliğinin ilgili bileşeni (güvenlik önerisi için ilgili bileşene benzer)	Microsoft Silverlight
requesterEmail	Dize	Oluşturucu e-posta adresi	globaladmin@UserName.contoso.com
requesterId	Dize	Oluşturucu nesne kimliği	r647211f-2e16-43f2-a480-16ar3a2a796r
requesterNotes	Dize	Oluşturucunun bu düzeltme etkinliği için eklediği notlar (serbest metin)	Null
Scid	Dize	İlgili güvenlik önerisinin SCID'sini	Null
Durum	Dize	Düzeltme etkinliği durumu (Etkin/Tamamlandı)	Etkin
statusLastModifiedOn	Datetime	Durum alanının güncelleştirilildiği tarih	2021-01-12T18:54:11.5499487Z
targetDevices	Uzun	Bu düzeltmenin uygulanabilecek kullanıma sunulan cihaz sayısı	43
Başlık	Dize	Bu düzeltme etkinliğinin başlığı	Microsoft Silverlight'ı güncelleştirme
Tür	Dize	Düzeltme türü	Güncelleştirme
Vendorıd	Dize	İlgili satıcı adı	Microsoft

Örnek

İstek örneği

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

Yanıt örneği

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

Ayrıca bkz.