Uppdatera dator

  • Artikel

Gäller för:

Vill du uppleva Microsoft Defender för Endpoint? Registrera dig för en kostnadsfri utvärderingsversion.

Obs!

Om du är en us government-kund använder du de URI:er som anges i Microsoft Defender för Endpoint för amerikanska myndighetskunder.

Tips

För bättre prestanda kan du använda servern närmare din geoplats:

  • 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-beskrivning

Uppdateringar egenskaper för befintlig dator.

Uppdateringsbara egenskaper är: machineTags och deviceValue.

Begränsningar

  1. Du kan uppdatera datorer som är tillgängliga i API:et.
  2. Uppdatera datorn lägger bara till taggar i taggsamlingen. Om det finns taggar måste de inkluderas i samlingen taggar i brödtexten.
  3. Hastighetsbegränsningar för det här API:et är 100 anrop per minut och 1 500 anrop per timme.

Behörigheter

En av följande behörigheter krävs för att anropa det här API:et. Mer information, inklusive hur du väljer behörigheter, finns i Använda Microsoft Defender för Endpoint-API:er

Behörighetstyp Behörighet Visningsnamn för behörighet
Program Machine.ReadWrite.All "Läsa och skriva datorinformation för alla datorer"
Delegerat (arbets- eller skolkonto) Machine.ReadWrite "Läsa och skriva datorinformation"

Obs!

När du hämtar en token med användarautentiseringsuppgifter:

  • Användaren måste ha minst följande rollbehörighet: "Undersökning av aviseringar". Mer information finns i Skapa och hantera roller.
  • Användaren måste ha åtkomst till den enhet som är associerad med aviseringen, baserat på enhetsgruppsinställningarna. Mer information finns i Skapa och hantera enhetsgrupper.

Skapande av enhetsgrupp stöds i Defender för Endpoint Plan 1 och Plan 2.

HTTP-begäran

PATCH /api/machines/{machineId}

Frågerubriker

Namn Typ Beskrivning
Tillstånd Sträng Ägaren {token}. Krävs.
Content-Type Sträng application/json. Krävs.

Frågebrödtext

Ange värdena för de relevanta fält som ska uppdateras i begärandetexten.

Befintliga egenskaper som inte ingår i begärandetexten behåller sina tidigare värden eller beräknas om baserat på ändringar i andra egenskapsvärden.

För bästa prestanda bör du inte inkludera befintliga värden som inte har ändrats.

Egenskap Typ Beskrivning
machineTags Strängsamling Uppsättning med datortaggar .
deviceValue Uppräkning som kan ha värdet Null Enhetens värde. Möjliga värden är: "Normal", "Low" och "High".

Svar

Om det lyckas returnerar den här metoden 200 OK och datorentiteten i svarstexten med de uppdaterade egenskaperna.

Om samlingen med datortaggar i brödtexten inte innehåller befintliga datortaggar ersätter alla taggar med taggarna som anges i begärandetexten.

Om datorn med det angivna ID:t inte hittades – 404 Hittades inte.

Exempel

Begäran

Här är ett exempel på begäran.

PATCH https://api.securitycenter.microsoft.com/api/machines/{machineId}

{
    "deviceValue": "Normal",
    "machineTags": [
                     "Demo Device",
                     "Generic User Machine - Attack Source",
                     "Windows 10" "Windows11",
                     "Windows Insider - Fast"
    ]
}

Tips

Vill du veta mer? Engage med Microsofts säkerhetscommunity i vår Tech Community: Microsoft Defender för Endpoint Tech Community.