Microsoft Intune -integraatio
Intune integration with Microsoft Graph API connector
Microsoft Intune -integraatio
Intune integration with Microsoft Graph API connector
Intune-integraatioon liittyvät ominaisuudet sisältyvät Microsoft Graph API -liittimeen (aiemmin Entra ID -liitin).
Microsoft Graph API -liittimellä voit lukea tietoja Microsoft Intunesta. Versiosta 2025.2 alkaen voit myös tehdä muutoksia/toimintoja Intuneen. Molempien ominaisuuksien ansiosta se tuottaa selkeää liiketoiminta-arvoa neljällä keskeisellä osa-alueella:
Parempi näkyvyys ja hallinta: Lähes reaaliaikainen pääsy laite- ja ohjelmistotietoihin parantaa IT-valvontaa, omaisuuden seurantaa ja päätöksentekoa.
Automaatio ja tehokkuus: Automatisoidut muutokset vähentävät manuaalista työtä, nopeuttavat reagointiaikoja ja tehostavat prosesseja, kuten käyttöönottoa ja päivityksiä.
Parempi tietoturva ja vaatimustenmukaisuus: Riskien nopea havaitseminen ja korjaaminen tukevat vahvempaa tietoturva-asennetta ja säädösten noudattamista.
Strateginen integraatio ja innovaatio: Saumaton integraatio muihin IT-järjestelmiin mahdollistaa älykkäämmän automaation, paremman hallinnan ja tukee digitaalisen muutoksen tavoitteita.
Microsoft Graph API -yhteyden ja tehtävän perusmäärityksistä katso Microsoft Graph API Connector -dokumentaatio.
Asiakasohjeet löydät osoitteesta https://docs.efecte.com/customer-instructions/efecte-provisioning-engine-customer-instructions-for-entra-id
Yleisimmät Intunen käyttötapaukset ovat
- Laitteiden lukeminen Intunesta CMDB:hen (tämä sisältyy 2025.1-perusversioon)
- Ohjelmistojen lukeminen Intunesta CMDB:hen
Laitteiden lukeminen Intunesta
Katso Microsoftin API-dokumentaatio: https://learn.microsoft.com/en-us/graph/api/resources/intune-devices-manageddevice?view=graph-rest-1.0
Entra ID -sovelluksen käyttöoikeudet
Intune-laitteiden tuontia varten Entra ID -sovellus tarvitsee seuraavat käyttöoikeudet
Asiakasohjeet löydät osoitteesta https://docs.efecte.com/customer-instructions/efecte-provisioning-engine-customer-instructions-for-entra-id
| Käyttöoikeustyyppi | Käyttöoikeus |
| Sovellus |
DeviceManagementManagedDevices.Read.All tai DeviceManagementManagedDevices.ReadWrite.All |
Kyselyt ajoitetulle tehtävälle
Ei ole suositeltavaa käyttää enempää kuin 3 alikyselyä, koska jokainen alikysely tekee tiedonhausta huomattavasti raskaamman.
Jos mahdollista, tee suorituskykytesti ennen tehtävän ottamista tuotantokäyttöön.
Poista alikyselyt, joita et käytä attribuuttien yhdistämisessä.
Jos sinun on haettava tietoa useammasta alikyselystä kuin mikä on suorituskyvyn kannalta hyväksyttävää, luo niille omat erilliset tehtävät ja käytä sitten ESM:n ominaisuuksia kahden tehtävän hakemien tietojen yhdistämiseen.
Kysely: deviceManagement/managedDevices
Alikyselyt (esimerkkejä mahdollisista alikyselyistä. Alla käytettyihin yhdistämisiin alikyselyjä ei tarvita):
deviceManagement/managedDevices/{id}/windowsProtectionState
deviceManagement/managedDevices/{id}/users
Yhdistämiset ajoitetulle tehtävälle
Käytä aina Generic Template -mallia Intune-yhdistämisten tyyppinä:
Ympäristössäsi saattaa olla eri kohdemalli ja/tai kohdekansio laitteille, joihin haluat tuoda laitteita Intunesta. Sinulla saattaa myös olla eri Task Id -yhdistämiskenttä ja Status-attribuutin arvo, kun laite poistetaan Intunesta. Tässä esimerkissä käytetään seuraavia arvoja: Kohdemalli - Device Kohdekansio - Asset/Server Task Id -yhdistäminen - Related connector task. Valitse attribuutti, johon tehtävätunnus tallennetaan, tässä esimerkissä "Related connector task". Sitä voidaan käyttää skripteissä määrittämään, mikä tehtävä on luonut/päivittänyt tietokortin. Tätä attribuuttia käytetään myös sisäisesti "Set value for deleted objects" -toiminnossa. Set value for deleted object - valittu Attribuutin nimi - Status Attribuutin arvo - 07 - Disposed
Perusesimerkki Intune-laitteiden yhdistämisistä. Saatat haluta yhdistää eri attribuutteja Intune-attribuuttien erilaisen käytön sekä erilaisten vaatimusten ja mallien vuoksi.
Nämä Intune-attribuutit eivät ole yhdistämisten pudotusvalikossa (vasen sarake), joten sinun on lisättävä ne napsauttamalla "+ New Attribute" -painiketta
Jos määrität tämän deviceManagement/managedDevices/{id}/windowsProtectionState-alikyselyn, voit lisätä yhdistämisen myös esimerkiksi näihin laitteiden windowsProtectionState-tilaan liittyviin Intune-attribuutteihin:
Tai jos lisäsit muita alikyselyjä, esimerkiksi: deviceManagement/managedDevices/{id}/users
voit yhdistää myös niitä.
Esimerkki attribuuttien yhdistämistaulukosta Intune-laitteille
Tämä taulukko sisältää yleisimmin käytetyt Intune-laitteisiin liittyvät attribuutit, mutta voit lisätä yhdistämistaulukkoon myös muita attribuutteja.
| Ulkoinen attribuutti | Paikallinen attribuuttikoodi | Paikallisen attribuutin nimi |
|---|---|---|
| activationLockBypassCode | intune_activationlockbypasscode | (lisää oma attribuutti tarvittaessa) |
| androidSecurityPatchLevel | intune_androidsecuritypatchlevel | Androidin tietoturvapäivitystaso |
| azureADDeviceId | intune_azureaddeviceid | AzureAD-laitetunnus |
| azureADRegistered | intune_azureadregistered | Onko laite rekisteröity Azure AD:hen |
| complianceState | intune_compliancestate | Laitteen vaatimustenmukaisuustila |
| deviceActionResults | intune_deviceactionresults | |
| deviceCategoryDisplayName | intune_devicecategorydisplayname | Laitekategorian näyttönimi |
| deviceEnrollmentType | intune_deviceenrollmenttype | Laitteen rekisteröintityyppi |
| deviceHealthAttestationState | intune_devicehealthattestationstate | Laitteen kuntotodennuksen tila |
| deviceName | intune_devicename | Intune-laitteen nimi |
| deviceRegistrationState | intune_deviceregistrationstate | Laitteen rekisteröintitila |
| easActivated | intune_easactivated | Onko Exchange ActiveSync aktivoitu |
| easActivationDateTime | intune_easactivationdatetime | Exchange ActiveSyncin aktivointiaika |
| easDeviceId | intune_easdeviceid | Exchange ActiveSync -tunnus |
| emailAddress | intune_emailaddress | Sähköpostiosoite |
| enrolledDateTime | intune_enrolleddatetime | Rekisteröintiaika |
| deviceManagement/managedDevices/{id}.ethernetMacAddress | intune_ethernetmacadress | Ethernet-MAC |
| exchangeAccessState | intune_exchangeaccessstate | Exchange-käyttötila |
| exchangeAccessStateReason | intune_exchangeaccessstatereason | Exchange-käyttötilan syy |
| exchangeLastSuccessfulSyncDateTime | intune_exchangelastsuccessfulsyncdatetime | Viimeisin ajankohta, jolloin laite oli yhteydessä Exchangeen |
| freeStorageSpaceInBytes | intune_freestoragespaceinbytes | Vapaa tallennustila tavuina |
| id | intune_id | Intune-tunnus |
| imei | intune_imei | (lisää oma attribuutti tarvittaessa) |
| isEncrypted | intune_isencrypted | Laitteen salaustila |
| isSupervised | intune_issupervised | Laitteen valvottu tila |
| jailBroken | intune_jailbroken | Onko jailbreikattu |
| lastSyncDateTime | intune_lastsyncdatetime | Viimeisin synkronointiaika |
| managedDeviceName | intune_manageddevicename | Hallitun laitteen nimi |
| managedDeviceOwnerType | intune_manageddeviceownertype | Intunen hallitun laitteen omistajatyyppi |
| managementAgent | intune_managementagent | Intunen hallinta-agentti |
| manufacturer | intune_manufacturer | Laitteen valmistaja |
| meid | intune_meid | MEID |
| model | intune_model | Laitteen malli |
| operatingSystem | intune_operatingsystem | Käyttöjärjestelmä |
| osVersion | intune_osversion | Intunen osVersion |
| partnerReportedThreatState | intune_partnerreportedthreatstate | Kumppanin raportoima uhkatila |
| phoneNumber | intune_phonenumber | Laitteen puhelinnumero |
| serialNumber | intune_serialnumber | Sarjanumero |
| subscriberCarrier | intue_subscribercarrier | Operaattori |
| totalStorageSpaceInBytes | intune_totalstoragespaceinbytes | Kokonaistallennustila tavuina |
| userDisplayName | intune_userdisplayname | Intunen userDisplayName |
| userId | intune_userid | Intunen userId |
| userPrincipalName | intune_userprincipalname | Laitteen käyttäjän pääkäyttäjänimi (UPN) |
| wiFiMacAddress | intune_wifimacaddress | Wi-Fi-MAC |
Yllä olevan taulukon ethernetMacAddress-attribuuttia varten sinun on myös määritettävä tämä alikysely samaan ajoitettuun tehtävään:
deviceManagement/managedDevices/{id}Ohjelmistojen lukeminen Intunesta
Katso Microsoftin API-dokumentaatio: https://learn.microsoft.com/en-us/graph/api/intune-devices-detectedapp-list?view=graph-rest-1.0&tabs=http
Entra ID -sovelluksen käyttöoikeudet
Intune-laitteiden tuontia varten Entra ID -sovellus tarvitsee seuraavat käyttöoikeudet
Asiakasohjeet löydät osoitteesta https://docs.efecte.com/customer-instructions/efecte-provisioning-engine-customer-instructions-for-entra-id
| Käyttöoikeustyyppi | Käyttöoikeus |
| Sovellus |
DeviceManagementManagedDevices.Read.All tai DeviceManagementManagedDevices.ReadWrite.All |
Kyselyt ajoitetulle tehtävälle
Kysely: deviceManagement/detectedApps
Alikyselyt: deviceManagement/detectedApps/{id}/managedDevices
Yhdistämiset ajoitetulle tehtävälle
Käytä aina Generic Template -mallia Intune-yhdistämisten tyyppinä:
Yhdistäminen alikyselyn laitetunnuksille: deviceManagement/detectedApps/{id}/managedDevices.id
yhdistetty moniarvoiseen merkkijonoattribuuttiin devices.
Intune-laitteen tyhjentäminen (Wipe)
Wipe on yksi Intune-laitteiden tuetuista toiminnoista. Wipe-toiminnolla voit tyhjentää kadonneen laitteen tiedot. Kaikki toiminnot löydät luvusta "All supported actions for Intune devices" tällä sivulla.
Microsoftin dokumentaatio Wipe-toiminnolle: Wipen dokumentaatio
Tapahtumapohjainen tehtävä
Tapahtumapohjaisen tehtävän URL voi olla tyhjä. Lopullinen kutsuttava URL muodostetaan yhdistämällä liittimen URL ja työnkulkusolmun URL.
Yhdistämiset tapahtumapohjaiselle tehtävälle
Otsikko tapahtumapohjaiselle tehtävälle
Ylimääräisiä otsikoita ei tarvitse asettaa, Connector management asettaa tämän automaattisesti:
| Content-type | application/json |
Työnkulkusolmu
Valitse nämä Orchestrate-, Data Source- ja Activity-asetukset:
Valitse tapahtumapohjainen tehtävä, jonka teit tätä toimintoa varten. Voit myös käyttää yhtä tapahtumapohjaista tehtävää useille toiminnoille.
Activity: Generic REST API call
Type: POST
Url: deviceManagement/managedDevices/$attributecode_for_deviceid$/wipe
Body-esimerkki:
{ "keepEnrollmentData": true,
"keepUserData": false,
"macOsUnlockCode": "Mac Os Unlock Code value",
"persistEsimDataPlan": true }
Entra ID -sovelluksen käyttöoikeudet
Intune-laitteiden toimintoja varten Entra ID -sovellus tarvitsee seuraavat käyttöoikeudet
Asiakasohjeet löydät osoitteesta https://docs.efecte.com/customer-instructions/efecte-provisioning-engine-customer-instructions-for-entra-id
| Käyttöoikeustyyppi | Käyttöoikeus |
|---|---|
| Sovellus |
DeviceManagementManagedDevices.ReadWrite.All tai DeviceManagementManagedDevices.PrivilegedOperations.All |
Muut Intune-laitteiden toiminnot
Entra ID -sovelluksen käyttöoikeudet
Intune-laitteiden toimintoja varten Entra ID -sovellus tarvitsee käyttöoikeuksia. Oikeiden käyttöoikeuksien määrittämiseksi katso: https://docs.efecte.com/customer-instructions/efecte-provisioning-engine-customer-instructions-for-entra-id ja https://learn.microsoft.com/en-us/graph/permissions-reference
Tapahtumapohjainen tehtävä
Tapahtumapohjaisen tehtävän URL voi olla tyhjä. Lopullinen kutsuttava URL muodostetaan yhdistämällä liittimen URL ja työnkulkusolmun URL.
Yhdistämiset tapahtumapohjaiselle tehtävälle
Otsikko tapahtumapohjaiselle tehtävälle
Ylimääräisiä otsikoita ei tarvitse asettaa, Connector management asettaa tämän automaattisesti:
| Content-type | application/json |
Työnkulkusolmu
Valitse Workflow Orchestration -solmussa nämä Orchestrate-, Data Source- ja Activity-asetukset:
Valitse tapahtumapohjainen tehtävä, jonka teit tätä toimintoa varten. Voit myös käyttää yhtä tapahtumapohjaista tehtävää useille toiminnoille.
Kaikki nämä toiminnot käyttävät HTTP-metodia POST, paitsi laitteen poistaminen Intunesta, joka käyttää DELETE-metodia.
Huomaa! Toimintojen URL-osoitteissa muista asettaa oikea attribuutti kohtaan $attributecode_for_deviceid$ joko suoraan tietokortista tai viittauksen kautta $referencedata:attributecode_for_deviceid$.
Laitteen elinkaari ja vaatimustenmukaisuus
Wipe Tyhjennä laitteen tiedot (valinnaisesti säilytä käyttäjän tiedot). Wipen dokumentaatio
Url: deviceManagement/managedDevices/$attributecode_for_deviceid$/wipe
{ "keepEnrollmentData": true,
"keepUserData": false,
"macOsUnlockCode": "Mac Os Unlock Code value",
"persistEsimDataPlan": true }
Retire Poista yrityksen tiedot ja hallintaprofiili laitteesta. Retiren dokumentaatio
Url: deviceManagement/managedDevices/$attributecode_for_deviceid$/retire
Delete Poista laitetietue pysyvästi Intunesta. Delete-toiminnon dokumentaatio
Toimintotyyppi: DELETE
Url: deviceManagement/managedDevices/$attributecode_for_deviceid$
Clean Windows Device Suorita puhdas Windowsin uudelleenasennus. Clean-toiminnon dokumentaatio
Url: deviceManagement/managedDevices/$attributecode_for_deviceid$/cleanWindowsDevice
Sync Device Pakota laite ilmoittautumaan Intuneen. Sync-toiminnon dokumentaatio
Url: deviceManagement/managedDevices/$attributecode_for_deviceid$/syncDevice
Tietoturva ja hallinta
Remote Lock Lukitse laite etänä.
Etälukitus on tuettu laitteissa, joissa on käytössä:
- Android
- iOS
Url: deviceManagement/managedDevices/$attributecode_for_deviceid$/remoteLock
Reset Passcode (vain iOS/iPadOS) Nollaa laitteen suojakoodi. Salasanan nollauksen dokumentaatio
Url: deviceManagement/managedDevices/$attributecode_for_deviceid$/resetPasscode
Body-esimerkki: { "password": "Temparary-??-42?!" }
Enable/Disable Lost Mode (vain iOS) Seuraa kadonneita laitteita Lost Mode -tilan avulla.
Huomaa! Microsoft ei ole vielä lisännyt tätä Graph APIn v1-versioon. Jotta voit kutsua näitä API:ja, liittimen on käytettävä Microsoft Graph APIn beta-versiota. Liittimen Graph API -URL: https://graph.microsoft.com/beta/ Enable lost mode -toiminnon dokumentaatio 
Disable lost mode -toiminnon dokumentaatio
Url: deviceManagement/managedDevices/$attributecode_for_deviceid$/enableLostMode
Body-esimerkki: { "footer": "Please return this device to CompanyX IT", "message": "Device lost. Contact companyX IT department at +358999999999.", "phoneNumber": "+358999999999" }
Locate Device Hae kadonneen laitteen GPS-koordinaatit. Locate Device -toiminnon dokumentaatio
Url: deviceManagement/managedDevices/$attributecode_for_deviceid$/locateDevice
Body-esimerkki: { "deviceTag": "HRDeptTempTag" }
Restart Now (vain Windows) Käynnistä laite uudelleen etänä. Restart-toiminnon dokumentaatio
Url: deviceManagement/managedDevices/$attributecode_for_deviceid$/restartNow
Shut Down (vain Windows) Sammuta laite etänä. Shutdown-toiminnon dokumentaatio
Url: deviceManagement/managedDevices/$attributecode_for_deviceid$/shutdown
Rotate BitLocker Keys Vaihda BitLocker-palautusavaimet tietoturvan parantamiseksi. Rotate BitLocker Keys -toiminnon dokumentaatio
Url: deviceManagement/managedDevices/$attributecode_for_deviceid$/rotateBitLockerKeys
Määritys ja Cloud PC
Set Device Name Anna laitteelle uusi nimi. Set Device Name -toiminnon dokumentaatio
Url: deviceManagement/managedDevices/$attributecode_for_deviceid$/setDeviceName
Body-esimerkki: { "deviceName": "Finance-Laptop-20250123" }
Lisää Intuneen liittyviä esimerkkejä
Tämä luku antaa esimerkkejä siitä, miten sitä voidaan käyttää Intune-tietojen hakemiseen.
Intune-laitteiden hakeminen
Alla oleva esimerkki näyttää, miten haetaan Intune-laitteet, laitteen ensisijainen käyttäjä ja laitteen Windowsin suojaustila.
Jos haluat käyttää suodattimia Microsoft Entra -kyselyssä kohteelle deviceManagement/managedDevices, tarkista tämä Microsoftin dokumentti: https://learn.microsoft.com/en-us/graph/api/resources/intune-devices-manageddevice?view=graph-rest-1.0
Tässä on yksi esimerkki suodattamisesta, joka suodattaa laitteet, joiden complianceState on noncompliant: deviceManagement/managedDevices?$filter=complianceState eq 'noncompliant'
Attribuuttien yhdistäminen
Intune-kyselyn ja alikyselyjen avulla tässä on esimerkkejä siitä, miten tietoja luetaan attribuuttien yhdistämisillä:
Lisää Intune-yhdistämisesimerkkejä:
Yhdistäminen alikyselystä
Jos haluat lukea attribuutin alikyselystä, sillä on oma muotonsa. Ensin tarvitset alikyselyn etuliitteenä, sitten pisteen (.) ja sen jälkeen luettavan attribuutin nimen.
Tarkastellaan esimerkkinä tätä yhdistämistä tarkemmin: /deviceManagement/managedDevices/{id}/windowsProtectionState . deviceState
etuliite (sama kuin alikysely): /deviceManagement/managedDevices/{id}/windowsProtectionState
piste: .
loppuliite attribuutin nimenä alikyselyn tulosjoukosta: deviceState
Tämä alikyselyn yhdistäminen lukee kaikkien pääkyselyn tuloksena saatujen laitteiden windowsProtectionState-objektista, ja sieltä se lukee deviceState-attribuutin arvon.
Tähän Intune-esimerkkiin liittyvät Microsoft Graph API -tiedot
https://learn.microsoft.com/en-us/graph/api/intune-devices-manageddevice-list?view=graph-rest-1.0
Intune-sovellusten hakeminen
Alla oleva esimerkki näyttää, miten haetaan Intune-sovellukset ja laitteet, joissa nämä sovellukset ovat käytössä.
Microsoft Entra -kysely: deviceManagement/detectedApps
Alikyselyt: deviceManagement/detectedApps/{id}/managedDevices
Attribuuttien yhdistäminen
Intune-kyselyn ja alikyselyjen avulla tässä on kolme esimerkkiä yhdistämisistä:
displayName
platform
deviceManagement/detectedApps/{id}/managedDevices.operatingSystem
Tähän Intune-esimerkkiin liittyvät Microsoft Graph API -tiedot
https://learn.microsoft.com/en-us/graph/api/resources/intune-devices-detectedapp?view=graph-rest-1.0
Tunnetut rajoitukset
Rajoitukset versiossa 2025.2 ja sitä vanhemmissa
Microsoft Intunen raportointi-API https://graph.microsoft.com/beta/deviceManagement/reports/exportJobs ei ole tuettu https://learn.microsoft.com/en-us/intune/intune-service/fundamentals/reports-export-graph-available-reports
Useampaa kuin yhtä alikyselytasoa ei tueta suorituskykysyistä.
Useampaa kuin yhtä alikyselyä ei tueta versioita 2025.3 vanhemmissa. Tuki tälle lisättiin versioon 2025.3.
Liitin ei tue Intune-objektien merkitsemistä poistetuiksi Matrix42 Core-, Pro- ja IGA-järjestelmissä, kun objekti poistetaan Microsoft Intunesta versioita 2025.3 vanhemmissa. Tuki tälle lisättiin versioon 2025.3.
Rajoitukset versiossa 2025.3
Microsoft Intunen raportointi-API https://graph.microsoft.com/beta/deviceManagement/reports/exportJobs ei ole tuettu https://learn.microsoft.com/en-us/intune/intune-service/fundamentals/reports-export-graph-available-reports
Useampaa kuin yhtä alikyselytasoa ei tueta suorituskykysyistä.
Vianmääritys
Table of Contents