Atualizar windowsMalwareInformation

Artigo
08/03/2024

Namespace: microsoft.graph

Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.

Atualize as propriedades de um objeto windowsMalwareInformation .

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global	US Government L4	US Government L5 (DOD)	China operada pela 21Vianet
✅	✅	✅	✅

Permissões

Uma das seguintes permissões é necessária para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão	Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante)	DeviceManagementManagedDevices.ReadWrite.All
Delegado (conta pessoal da Microsoft)	Sem suporte.
Application	DeviceManagementManagedDevices.ReadWrite.All

Solicitação HTTP

PATCH /deviceManagement/windowsMalwareInformation/{windowsMalwareInformationId}

Cabeçalhos de solicitação

Cabeçalho	Valor
Autorização	{token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Aceitar	application/json

Corpo da solicitação

No corpo do pedido, forneça uma representação JSON para o objeto windowsMalwareInformation .

A tabela seguinte mostra as propriedades necessárias quando cria o windowsMalwareInformation.

Propriedade	Tipo	Descrição
id	Cadeia de caracteres	O Identificador exclusivo. Trata-se de um ID de software maligno.
displayName	Cadeia de caracteres	Indica o nome do software maligno
additionalInformationUrl	Cadeia de caracteres	Indica um URL informativo para saber mais sobre o software maligno
severity	windowsMalwareSeverity	Gravidade do software maligno. Os valores possíveis são: desconhecido, baixo, moderado, alto, grave. a predefinição é desconhecida. Os valores possíveis são: `unknown`, `low`, `moderate`, `high`, `severe`.
category	windowsMalwareCategory	Categoria do software maligno. Os valores possíveis são: inválido, adware, spyware, passwordStealer, trojanDownloader, worm, backdoor, remoteAccessTrojan, trojan, emailFlooder, keylogger, dialer, monitoringSoftware, browserModifier, cookie, browserPlugin, aolExploit, nuker, securityDisabler, jokeProgram, hostileActiveXControl, softwareBundler, stealthNotifier, settingsModifier, toolBar, remoteControlSoftware, trojanFtp, potentialUnwantedSoftware, icqExploit, trojanTelnet, exploit, filesharingProgram, malwareCreationTool, remote_Control_Software, tool, trojanDenialOfService, trojanDropper, trojanMassMailer, trojanMonitoringSoftware, trojanProxyServer, virus, known, unknown, spp, behavior, vulnerability, policy, enterpriseUnwantedSoftware, ransom, hipsRule. o valor predefinido é inválido. Os valores possíveis são: `invalid`, , `adware`, `passwordStealerspyware`, `trojanDownloader`, `worm`, `backdoorremoteAccessTrojan`, `trojan`, `emailFlooder`, `keylogger`, `dialer`, `browserModifiertrojanMassMailermonitoringSoftwarebrowserPlugincookieaolExploitremoteControlSoftwaretrojanFtptoolBarsettingsModifierstealthNotifierpotentialUnwantedSoftwaresoftwareBundlerhostileActiveXControlicqExploitjokeProgramtrojanTelnetsecurityDisablerfilesharingProgramtrojanDenialOfServicetrojanMonitoringSoftwaremalwareCreationToolexploitremote_Control_SoftwaretrojanProxyServernukertrojanDroppervirusunknownknowntool`, , `behaviorspp`, , `vulnerability`, `policy`, , , `enterpriseUnwantedSoftware`, , . `hipsRuleransom`
lastDetectionDateTime	DateTimeOffset	Indica a última vez que o software maligno foi detetado em UTC

Resposta

Se for bem-sucedido, este método devolve um 200 OK código de resposta e um objeto windowsMalwareInformation atualizado no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

PATCH https://graph.microsoft.com/v1.0/deviceManagement/windowsMalwareInformation/{windowsMalwareInformationId}
Content-type: application/json
Content-length: 299

{
  "@odata.type": "#microsoft.graph.windowsMalwareInformation",
  "displayName": "Display Name value",
  "additionalInformationUrl": "https://example.com/additionalInformationUrl/",
  "severity": "low",
  "category": "adware",
  "lastDetectionDateTime": "2016-12-31T23:59:27.3805104-08:00"
}


// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new WindowsMalwareInformation
{
	OdataType = "#microsoft.graph.windowsMalwareInformation",
	DisplayName = "Display Name value",
	AdditionalInformationUrl = "https://example.com/additionalInformationUrl/",
	Severity = WindowsMalwareSeverity.Low,
	Category = WindowsMalwareCategory.Adware,
	LastDetectionDateTime = DateTimeOffset.Parse("2016-12-31T23:59:27.3805104-08:00"),
};

// To initialize your graphClient, see https://video2.skills-academy.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.DeviceManagement.WindowsMalwareInformation["{windowsMalwareInformation-id}"].PatchAsync(requestBody);

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.



mgc device-management windows-malware-information patch --windows-malware-information-id {windowsMalwareInformation-id} --body '{\
  "@odata.type": "#microsoft.graph.windowsMalwareInformation",\
  "displayName": "Display Name value",\
  "additionalInformationUrl": "https://example.com/additionalInformationUrl/",\
  "severity": "low",\
  "category": "adware",\
  "lastDetectionDateTime": "2016-12-31T23:59:27.3805104-08:00"\
}\
'

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.



// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  "time"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
	  //other-imports
)

requestBody := graphmodels.NewWindowsMalwareInformation()
displayName := "Display Name value"
requestBody.SetDisplayName(&displayName) 
additionalInformationUrl := "https://example.com/additionalInformationUrl/"
requestBody.SetAdditionalInformationUrl(&additionalInformationUrl) 
severity := graphmodels.LOW_WINDOWSMALWARESEVERITY 
requestBody.SetSeverity(&severity) 
category := graphmodels.ADWARE_WINDOWSMALWARECATEGORY 
requestBody.SetCategory(&category) 
lastDetectionDateTime , err := time.Parse(time.RFC3339, "2016-12-31T23:59:27.3805104-08:00")
requestBody.SetLastDetectionDateTime(&lastDetectionDateTime) 

// To initialize your graphClient, see https://video2.skills-academy.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
windowsMalwareInformation, err := graphClient.DeviceManagement().WindowsMalwareInformation().ByWindowsMalwareInformationId("windowsMalwareInformation-id").Patch(context.Background(), requestBody, nil)

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

WindowsMalwareInformation windowsMalwareInformation = new WindowsMalwareInformation();
windowsMalwareInformation.setOdataType("#microsoft.graph.windowsMalwareInformation");
windowsMalwareInformation.setDisplayName("Display Name value");
windowsMalwareInformation.setAdditionalInformationUrl("https://example.com/additionalInformationUrl/");
windowsMalwareInformation.setSeverity(WindowsMalwareSeverity.Low);
windowsMalwareInformation.setCategory(WindowsMalwareCategory.Adware);
OffsetDateTime lastDetectionDateTime = OffsetDateTime.parse("2016-12-31T23:59:27.3805104-08:00");
windowsMalwareInformation.setLastDetectionDateTime(lastDetectionDateTime);
WindowsMalwareInformation result = graphClient.deviceManagement().windowsMalwareInformation().byWindowsMalwareInformationId("{windowsMalwareInformation-id}").patch(windowsMalwareInformation);

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.


const options = {
	authProvider,
};

const client = Client.init(options);

const windowsMalwareInformation = {
  '@odata.type': '#microsoft.graph.windowsMalwareInformation',
  displayName: 'Display Name value',
  additionalInformationUrl: 'https://example.com/additionalInformationUrl/',
  severity: 'low',
  category: 'adware',
  lastDetectionDateTime: '2016-12-31T23:59:27.3805104-08:00'
};

await client.api('/deviceManagement/windowsMalwareInformation/{windowsMalwareInformationId}')
	.update(windowsMalwareInformation);

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.


<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\WindowsMalwareInformation;
use Microsoft\Graph\Generated\Models\WindowsMalwareSeverity;
use Microsoft\Graph\Generated\Models\WindowsMalwareCategory;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new WindowsMalwareInformation();
$requestBody->setOdataType('#microsoft.graph.windowsMalwareInformation');
$requestBody->setDisplayName('Display Name value');
$requestBody->setAdditionalInformationUrl('https://example.com/additionalInformationUrl/');
$requestBody->setSeverity(new WindowsMalwareSeverity('low'));
$requestBody->setCategory(new WindowsMalwareCategory('adware'));
$requestBody->setLastDetectionDateTime(new \DateTime('2016-12-31T23:59:27.3805104-08:00'));

$result = $graphServiceClient->deviceManagement()->windowsMalwareInformation()->byWindowsMalwareInformationId('windowsMalwareInformation-id')->patch($requestBody)->wait();

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.


Import-Module Microsoft.Graph.DeviceManagement

$params = @{
	"@odata.type" = "#microsoft.graph.windowsMalwareInformation"
	displayName = "Display Name value"
	additionalInformationUrl = "https://example.com/additionalInformationUrl/"
	severity = "low"
	category = "adware"
	lastDetectionDateTime = [System.DateTime]::Parse("2016-12-31T23:59:27.3805104-08:00")
}

Update-MgDeviceManagementWindowsMalwareInformation -WindowsMalwareInformationId $windowsMalwareInformationId -BodyParameter $params

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.windows_malware_information import WindowsMalwareInformation
from msgraph.generated.models.windows_malware_severity import WindowsMalwareSeverity
from msgraph.generated.models.windows_malware_category import WindowsMalwareCategory
# To initialize your graph_client, see https://video2.skills-academy.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = WindowsMalwareInformation(
	odata_type = "#microsoft.graph.windowsMalwareInformation",
	display_name = "Display Name value",
	additional_information_url = "https://example.com/additionalInformationUrl/",
	severity = WindowsMalwareSeverity.Low,
	category = WindowsMalwareCategory.Adware,
	last_detection_date_time = "2016-12-31T23:59:27.3805104-08:00",
)

result = await graph_client.device_management.windows_malware_information.by_windows_malware_information_id('windowsMalwareInformation-id').patch(request_body)

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

Resposta

Veja a seguir um exemplo da resposta. Observação: o objeto response mostrado aqui pode estar truncado por motivos de concisão. Todas as propriedades serão retornadas de uma chamada real.

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 348

{
  "@odata.type": "#microsoft.graph.windowsMalwareInformation",
  "id": "8ebd2b9b-2b9b-8ebd-9b2b-bd8e9b2bbd8e",
  "displayName": "Display Name value",
  "additionalInformationUrl": "https://example.com/additionalInformationUrl/",
  "severity": "low",
  "category": "adware",
  "lastDetectionDateTime": "2016-12-31T23:59:27.3805104-08:00"
}

Compartilhar via

Atualizar windowsMalwareInformation

Permissões

Solicitação HTTP

Cabeçalhos de solicitação

Corpo da solicitação

Resposta

Exemplo

Solicitação

Resposta

Comentários

Recursos adicionais