Aktualisieren von „windowsDefenderAdvancedThreatProtectionConfiguration“
Artikel
12/04/2023
11 Mitwirkende
Feedback
In diesem Artikel
Namespace: microsoft.graph
Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.
Diese Methode aktualisiert die Eigenschaften von Objekten des Typs windowsDefenderAdvancedThreatProtectionConfiguration .
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst
US Government L4
US Government L5 (DOD)
China, betrieben von 21Vianet
✅
✅
✅
✅
Berechtigungen
Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen .
Berechtigungstyp
Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)
DeviceManagementConfiguration.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)
Nicht unterstützt
Anwendung
DeviceManagementConfiguration.ReadWrite.All
HTTP-Anforderung
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}
Anforderungstext
Geben Sie als Anforderungstext eine JSON-Darstellung des Objekts des Typs windowsDefenderAdvancedThreatProtectionConfiguration an.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die angegeben werden müssen, wenn Sie ein Objekt des Typs windowsDefenderAdvancedThreatProtectionConfiguration erstellen.
Eigenschaft
Typ
Beschreibung
id
String
Schlüssel der Entität Geerbt von deviceConfiguration .
lastModifiedDateTime
DateTimeOffset
Datum und Uhrzeit der letzten Änderung des Objekts. Geerbt von deviceConfiguration .
createdDateTime
DateTimeOffset
Datum und Uhrzeit der Erstellung des Objekts. Geerbt von deviceConfiguration .
description
String
Beschreibung der Gerätekonfiguration (vom Administrator festgelegt). Geerbt von deviceConfiguration .
displayName
String
Name der Gerätekonfiguration (vom Administrator festgelegt). Geerbt von deviceConfiguration .
Version
Int32
Version der Gerätekonfiguration. Geerbt von deviceConfiguration .
allowSampleSharing
Boolean
Regel „Beispielfreigabe zulassen“ in Windows Defender Advanced Threat Protection
enableExpeditedTelemetryReporting
Boolean
Verkürzt das Meldungsintervall für Windows Defender Advanced Threat Protection-Telemetriedaten.
Antwort
Bei erfolgreicher Ausführung gibt die Methode den Antwortcode 200 OK
und ein aktualisiertes Objekt des Typs windowsDefenderAdvancedThreatProtectionConfiguration im Antworttext zurück.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
PATCH https://graph.microsoft.com/v1.0/deviceManagement/deviceConfigurations/{deviceConfigurationId}
Content-type: application/json
Content-length: 267
{
"@odata.type": "#microsoft.graph.windowsDefenderAdvancedThreatProtectionConfiguration",
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"allowSampleSharing": true,
"enableExpeditedTelemetryReporting": true
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new WindowsDefenderAdvancedThreatProtectionConfiguration
{
OdataType = "#microsoft.graph.windowsDefenderAdvancedThreatProtectionConfiguration",
Description = "Description value",
DisplayName = "Display Name value",
Version = 7,
AllowSampleSharing = true,
EnableExpeditedTelemetryReporting = true,
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.DeviceManagement.DeviceConfigurations["{deviceConfiguration-id}"].PatchAsync(requestBody);
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen , finden Sie in der SDK-Dokumentation .
// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc device-management device-configurations patch --device-configuration-id {deviceConfiguration-id} --body '{\
"@odata.type": "#microsoft.graph.windowsDefenderAdvancedThreatProtectionConfiguration",\
"description": "Description value",\
"displayName": "Display Name value",\
"version": 7,\
"allowSampleSharing": true,\
"enableExpeditedTelemetryReporting": true\
}\
'
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen , finden Sie in der SDK-Dokumentation .
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
//other-imports
)
graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)
requestBody := graphmodels.NewDeviceConfiguration()
description := "Description value"
requestBody.SetDescription(&description)
displayName := "Display Name value"
requestBody.SetDisplayName(&displayName)
version := int32(7)
requestBody.SetVersion(&version)
allowSampleSharing := true
requestBody.SetAllowSampleSharing(&allowSampleSharing)
enableExpeditedTelemetryReporting := true
requestBody.SetEnableExpeditedTelemetryReporting(&enableExpeditedTelemetryReporting)
deviceConfigurations, err := graphClient.DeviceManagement().DeviceConfigurations().ByDeviceConfigurationId("deviceConfiguration-id").Patch(context.Background(), requestBody, nil)
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen , finden Sie in der SDK-Dokumentation .
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
WindowsDefenderAdvancedThreatProtectionConfiguration deviceConfiguration = new WindowsDefenderAdvancedThreatProtectionConfiguration();
deviceConfiguration.setOdataType("#microsoft.graph.windowsDefenderAdvancedThreatProtectionConfiguration");
deviceConfiguration.setDescription("Description value");
deviceConfiguration.setDisplayName("Display Name value");
deviceConfiguration.setVersion(7);
deviceConfiguration.setAllowSampleSharing(true);
deviceConfiguration.setEnableExpeditedTelemetryReporting(true);
DeviceConfiguration result = graphClient.deviceManagement().deviceConfigurations().byDeviceConfigurationId("{deviceConfiguration-id}").patch(deviceConfiguration);
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen , finden Sie in der SDK-Dokumentation .
const options = {
authProvider,
};
const client = Client.init(options);
const deviceConfiguration = {
'@odata.type': '#microsoft.graph.windowsDefenderAdvancedThreatProtectionConfiguration',
description: 'Description value',
displayName: 'Display Name value',
version: 7,
allowSampleSharing: true,
enableExpeditedTelemetryReporting: true
};
await client.api('/deviceManagement/deviceConfigurations/{deviceConfigurationId}')
.update(deviceConfiguration);
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen , finden Sie in der SDK-Dokumentation .
<?php
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new WindowsDefenderAdvancedThreatProtectionConfiguration();
$requestBody->setOdataType('#microsoft.graph.windowsDefenderAdvancedThreatProtectionConfiguration');
$requestBody->setDescription('Description value');
$requestBody->setDisplayName('Display Name value');
$requestBody->setVersion(7);
$requestBody->setAllowSampleSharing(true);
$requestBody->setEnableExpeditedTelemetryReporting(true);
$result = $graphServiceClient->deviceManagement()->deviceConfigurations()->byDeviceConfigurationId('deviceConfiguration-id')->patch($requestBody)->wait();
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen , finden Sie in der SDK-Dokumentation .
Import-Module Microsoft.Graph.DeviceManagement
$params = @{
"@odata.type" = "#microsoft.graph.windowsDefenderAdvancedThreatProtectionConfiguration"
description = "Description value"
displayName = "Display Name value"
version = 7
allowSampleSharing = $true
enableExpeditedTelemetryReporting = $true
}
Update-MgDeviceManagementDeviceConfiguration -DeviceConfigurationId $deviceConfigurationId -BodyParameter $params
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen , finden Sie in der SDK-Dokumentation .
from msgraph import GraphServiceClient
from msgraph.generated.models.windows_defender_advanced_threat_protection_configuration import WindowsDefenderAdvancedThreatProtectionConfiguration
graph_client = GraphServiceClient(credentials, scopes)
request_body = WindowsDefenderAdvancedThreatProtectionConfiguration(
odata_type = "#microsoft.graph.windowsDefenderAdvancedThreatProtectionConfiguration",
description = "Description value",
display_name = "Display Name value",
version = 7,
allow_sample_sharing = True,
enable_expedited_telemetry_reporting = True,
)
result = await graph_client.device_management.device_configurations.by_device_configuration_id('deviceConfiguration-id').patch(request_body)
Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen , finden Sie in der SDK-Dokumentation .
Antwort
Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 439
{
"@odata.type": "#microsoft.graph.windowsDefenderAdvancedThreatProtectionConfiguration",
"id": "294373aa-73aa-2943-aa73-4329aa734329",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
"description": "Description value",
"displayName": "Display Name value",
"version": 7,
"allowSampleSharing": true,
"enableExpeditedTelemetryReporting": true
}