Apparaatquery voor meerdere apparaten

Opmerking

Deze mogelijkheid is beschikbaar als een Intune-invoegtoepassing. Zie Invoegtoepassingsmogelijkheden van Intune Suite gebruiken voor meer informatie.

Met apparaatquery's voor meerdere apparaten kunt u uitgebreide inzichten krijgen over uw hele apparatenpark met behulp van Kusto-querytaal (KQL) voor het doorzoeken van verzamelde inventarisgegevens voor uw apparaten.

Voordat u begint

• Controleer of uw omgeving voldoet aan alle vereisten.

Aanvullende vereisten voor apparaatquery's voor meerdere apparaten:

Vereisten voor apparaatplatform

Apparaatquery voor meerdere apparaten ondersteunt:

• Windows
• Android
  • Toegewezen Android Enterprise-apparaten in bedrijfseigendom (COSU)
  • Volledig beheerd door Android Enterprise (COBO) in bedrijfseigendom
  • Android Enterprise-werkprofiel in bedrijfseigendom (COPE)
• Appel
  • iOS/iPadOS
  • macOS

Apparaatconfiguratievereisten

Apparaatquery voor meerdere apparaten ondersteunt apparaten die:

• Beheerd door Intune en gemarkeerd als bedrijfseigendom
• Op Windows-apparaten moet een eigenschappencatalogusbeleid zijn geïmplementeerd om inventarisgegevens te verzamelen.
  Voor iOS/iPadOS, Android en macOS worden gegevens automatisch verzameld en hoeft er geen afzonderlijk catalogusbeleid voor eigenschappen te worden geïmplementeerd.

Vereisten voor rollen

Als u een apparaatquery wilt gebruiken voor meerdere apparaten, gebruikt u een account met ten minste een van de volgende rollen:

• Helpdeskmedewerker
• Aangepaste rol die het volgende omvat:
  • De machtiging Beheerde apparaten/query
  • Machtigingen die inzicht bieden in en toegang bieden tot beheerde apparaten in Intune (bijvoorbeeld Organisatie/Lezen, Beheerde apparaten/Lezen)

Apparaatquery gebruiken voor meerdere apparaten

1. Selecteer apparaatquery>in het Microsoft Intune-beheercentrum.
2. Voer een query in het queryvak in met behulp van de ondersteunde eigenschappen en ondersteunde operators.
3. Selecteer Uitvoeren om de query uit te voeren.
4. Resultaten worden weergegeven in het tabblad Resultaten .
   • Als u slechts een deel van de query wilt uitvoeren of als u meerdere query's in het queryvenster hebt en er slechts één wilt uitvoeren, kunt u de query markeren die u wilt uitvoeren en Uitvoeren selecteren. Alleen die query wordt uitgevoerd.

U kunt de weergave aan de linkerkant uitvouwen om alle eigenschappen weer te geven die kunnen worden opgevraagd. Selecteer een die u in uw query wilt invullen. U kunt de randen van zowel de linkerkant als het queryvenster selecteren en slepen om eventuele aanpassingen aan te brengen.

Nadat u een query hebt uitgevoerd, selecteert u Exporteren om de resultaten op te slaan in een .CSV-bestand. U kunt alle kolommen in het queryresultaat exporteren of alleen de kolommen die u selecteert. U kunt maximaal 50.000 resultaten exporteren naar een bestand.

Zie Meer informatie over Kusto-querytaal voor meer informatie over Kusto-querytaal.

Tip

Gebruik Copilot in Intune om KQL-query's te genereren voor apparaatquery's met behulp van aanvragen in natuurlijke taal. Zie Query's uitvoeren met Copilot in apparaatquery voor meer informatie.

Voorbeeldquery's

In deze sectie vindt u enkele voorbeeldquery's om u op weg te helpen. Als u de voorbeeldquery's wilt openen, vouwt u de sectie voorbeeldquery's uit onder de pagina Aan de slag en selecteert u de query die u wilt toevoegen aan het queryvenster. In de volgende sectie ziet u de lijst met voorbeeldquery's.

Belangrijkste processors per aantal kernen

Deze query bevat de vijf belangrijkste CPU's gesorteerd op aantal kernen.

Cpu| project Device, ProcessorId, Model, Architecture, CpuStatus, ProcessorType, CoreCount, LogicalProcessorCount, Manufacturer, AddressWidth| order by CoreCount asc| take 5

Apparaten met niet-beveiligde schijven

In deze query worden apparaten met niet-versleutelde schijven vermeld.

EncryptableVolume| where ProtectionStatus != "PROTECTED"| join LogicalDrive

Arm64-apparaten

In deze query worden alle apparaten met een ARM64-processor weergegeven.

Cpu | where Architecture == "ARM64"

Aantal apparaten per processorarchitectuur

Deze query biedt een overzicht van apparaten per CPU-architectuur.

Cpu| summarize DeviceCount=count() by Architecture

Belangrijkste apparaten op batterijcapaciteit

In deze query worden de top 10 apparaten weergegeven op basis van volledig opgeladen batterijcapaciteit.

Battery| project Device, InstanceName, Manufacturer, Model, SerialNumber, CycleCount, DesignedCapacity, FullChargedCapacity, FullChargedCapacityPercent = (FullChargedCapacity*100)/DesignedCapacity| top 10 by FullChargedCapacityPercent asc

Geheugengegevens van apparaten

In deze query worden apparaten met fysiek en virtueel geheugen in GB weergegeven.

MemoryInfo| project Device, PhysicalMemoryGB = PhysicalMemoryTotalBytes/(1000*1000*1000), VirtualMemoryGB = VirtualMemoryTotalBytes/(1000*1000*1000) | order by PhysicalMemoryGB asc

Aantal apparaten per versie van het besturingssysteem

Deze query biedt een overzicht van apparaten per versie van het besturingssysteem.

OsVersion| summarize DevicesCount = count() by OsVersion

Bios-informatie over apparaten

In deze query worden apparaten vermeld op basis van de BIOS-fabrikant.

BiosInfo| where Manufacturer contains "Microsoft"

TPM-uitgeschakelde apparaten

In deze query worden apparaten vermeld waarvoor TPM is uitgeschakeld.

Tpm | where Enabled != true

Ondersteunde operators

Apparaatquery ondersteunt alleen een subset van de operators die worden ondersteund in de Kusto-querytaal (KQL). De volgende operators worden momenteel ondersteund:

Tabeloperators

Tabeloperators kunnen worden gebruikt om gegevensstromen te filteren, samen te vatten en te transformeren. De volgende operators worden ondersteund:

Tabeloperators	Beschrijving
count	Retourneert een tabel met één record met het aantal records.
distinct	Produceert een tabel met de unieke combinatie van de opgegeven kolommen van de invoertabel.
join	Voeg de rijen van twee tabellen samen om een nieuwe tabel te maken door de rij voor hetzelfde apparaat te vergelijken. Alleen de jointypen , inneruniqueLeftouter, Fullouter, Rightouteren inner worden ondersteund. Als u een ander jointype typt dan het ondersteunde type, worden deze genegeerd. Join-instructies ondersteunen de on syntaxis als deze is gekoppeld aan Device of Device.Deviceid. Algemene syntaxis voor join is LeftEntity | join [hints] (RightEntity) op Voorwaarden. Zie Deelnemen aan documentatie voor meer informatie.
order by	Sorteer de rijen van de invoertabel in volgorde op een of meer kolommen.
project	Selecteer de kolommen die u wilt opnemen, de naam ervan wilt wijzigen of verwijderen en voeg nieuwe berekende kolommen in.
take	Ga terug tot het opgegeven aantal rijen.
top	Retourneert de eerste N-records gesorteerd op de opgegeven kolommen.
where	Filter een tabel op de subset rijen die voldoen aan een predicaat.
summarize	produceert een tabel die de inhoud van de invoertabel samenvoegt.

Scalaire operators

Scalaire operators kunnen worden gebruikt om bewerkingen uit te voeren op afzonderlijke waarden. De volgende operators worden ondersteund:

Exploitanten	Beschrijving	Voorbeeld
==	Gelijk	1 == 1, 'aBc' == 'AbC'
!=	Niet gelijk	1 != 2, 'abc' != 'abcd'
<	Minder	1 < 2, 'abc' < 'DEF'
>	Groter	2 > 1, 'xyz' > 'XYZ'
<=	Kleiner of gelijk aan	1 <= 2, 'abc' <= 'abc'
>=	Groter of gelijk	2 >= 1, 'abc' >= 'ABC'
+	Toevoegen	2 + 1, now() + 1d
-	Aftrekken	2 - 1, now() - 1h
*	Vermenigvuldigen	2 * 2
/	Verdelen	2 / 1
%	Modulo	2 % 1
like	LHS bevat een overeenkomst voor RHS	'abc' like '%B%'
contains	RHS treedt op als een subsectie van LHS	'abc' contains 'b'
!contains	RHS komt niet voor in LHS	'team' !contains 'i'
startswith	RHS is een eerste subsectie van LHS	'team' startswith 'tea'
!startswith	RHS is geen eerste subsectie van LHS	'abc' !startswith 'bc'
endswith	RHS is een afsluitende subsectie van LHS	'abc' endswith 'bc'
!endswith	RHS is geen afsluitende subsectie van LHS	'abc' !endswith 'a'
and	Waar als en alleen als RHS en LHS waar zijn	(1 == 1) and (2 == 2)
or	Waar dan en alleen als RHS of LHS waar is	(1 == 1) or (1 == 2)

Aggregatiefuncties

Aggregatiefuncties kunnen worden gebruikt om gegevens samen te vatten. De volgende functies worden ondersteund:

Functie	Beschrijving
avg()	Retourneert het gemiddelde van de waarden in de groep
count()	Retourneert een telling van de records per samenvattingsgroep
countif()	Retourneert een aantal rijen waarvoor Predicaat waar wordt geëvalueerd
dcount()	Retourneert het aantal afzonderlijke waarden in de groep
max()	Retourneert de maximumwaarde in de groep
maxif()	Retourneert de maximumwaarde voor de groep waarvoor Predicaat waar wordt geëvalueerd
min()	Retourneert de minimumwaarde in de groep
minif()	Retourneert de minimumwaarde voor de groep waarvoor Predicaat waar wordt geëvalueerd
percentile()	Retourneert een schatting voor het opgegeven dichtstbijzijnde rangschikkings percentiel van de populatie die is gedefinieerd door Expr
sum()	Retourneert de som van de waarden in de groep
sumif()	Retourneert een som van Expr waarvoor Predicaat waar wordt geëvalueerd

Scalaire functies

Scalaire functies kunnen worden gebruikt om bewerkingen uit te voeren op afzonderlijke waarden. De volgende functies worden ondersteund:

Functie	Beschrijving
ago()	Trekt de opgegeven periode af van de huidige UTC-kloktijd.
bin()	Hiermee worden waarden naar beneden afgerond op een aantal datum/tijd veelvouden van een bepaalde bin-grootte.
case()	Evalueert een lijst met predicaten en retourneert de eerste resultaatexpressie waarvan het predicaat is voldaan.
datetime_add()	Berekent een nieuwe datum/tijd van een opgegeven datumdeel vermenigvuldigd met een opgegeven hoeveelheid, toegevoegd aan een opgegeven datum/tijd. Negatieve waarden voor de parameter hoeveelheid worden niet ondersteund.
datetime_diff()	Berekent het verschil tussen twee datum/tijd-waarden.
iif()	Evalueert het eerste argument en retourneert de waarde van de tweede of derde argumenten, afhankelijk van of het predicaat wordt geëvalueerd als waar (tweede) of onwaar (derde).
indexof()	Rapporteert de op nul gebaseerde index van het eerste exemplaar van een opgegeven tekenreeks in de invoertekenreeks.
isnotnull()	Evalueert het enige argument en retourneert een Booleaanse waarde die aangeeft of het argument een niet-null-waarde oplevert.
isnull()	Evalueert het enige argument en retourneert een Booleaanse waarde die aangeeft of het argument een null-waarde oplevert.
now()	Retourneert de huidige UTC-kloktijd.
strcat()	Voegt 1 tot 64 argumenten samen.
strlen()	Retourneert de lengte, in tekens, van de invoertekenreeks.
substring()	Extraheert een subtekenreeks uit een brontekenreeks die begint van een index tot het einde van de tekenreeks.
tostring()	Hiermee wordt invoer geconverteerd naar een tekenreeksweergave.

Ondersteunde eigenschappen

Apparaatquery ondersteunt de volgende entiteiten. Zie Intune Data Platform Schema voor meer informatie over welke eigenschappen worden ondersteund voor elke entiteit.

• Apple Auto Setup Admin Accounts
• Apple Device States
• Apple Update Settings
• Battery
• Bios Info
• Bluetooth
• Cellular
• CPU
• Device Storage
• Disk Drive
• Encryptable Volume
• Logical Drive
• Memory Info
• Network Adapter
• Os Version
• Shared iPad
• Sim Info
• System Enclosure
• SystemInfo
• Time
• Tpm
• Video Controller
• Windows Qfe

Apparaatentiteit

Apparaatquery voor meerdere apparaten ondersteunt een gekoppelde entiteit. De entiteit Apparaat kan worden gebruikt met alle andere ondersteunde entiteiten. De apparaatentiteit ondersteunt de volgende eigenschappen:

Eigenschap	Type	Beschrijving
DeviceId	Tekenreeks	Een unieke id die door Intune wordt gegenereerd als onderdeel van de apparaatinschrijving.
EntraDeviceId	Tekenreeks	Unieke id gegenereerd door Microsoft Entra als onderdeel van Microsoft Entra registratie of join.
ManagementName	Tekenreeks	Een gemakkelijk herkenbare apparaatnaam die alleen wordt gebruikt in het Intune-beheercentrum. Als u deze naam wijzigt, wordt de naam van het apparaat of de naam in de Bedrijfsportal niet gewijzigd.
DeviceName	Tekenreeks	Naam van het apparaat
SerialNumber	Tekenreeks	Serienummer van het apparaat
Manufacturer	Tekenreeks	Fabrikant van het apparaat
Model	Tekenreeks	Model van het apparaat
OSDescription	Tekenreeks	Volledige beschrijving van de editie van het besturingssysteem
OSVersion	Tekenreeks	De versie van het besturingssysteem op het apparaat
EnrollmentProfileName	Tekenreeks	Naam van het inschrijvingsprofiel dat is toegewezen aan het apparaat. De standaardwaarde is een lege tekenreeks die aangeeft dat er geen inschrijvingsprofiel is toegewezen aan het apparaat.
EnrolledDateTime	Datum/tijd	De datum en tijd waarop het apparaat is ingeschreven bij Intune.
CertExpirationDateTime	Datum/tijd	Rapporteert de vervaldatum van het certificaat voor apparaatbeheer.
EnrolledByUserId	Tekenreeks	Unieke id voor de gebruiker die het apparaat heeft ingeschreven
PrimaryUserId	Tekenreeks	Unieke id voor de gebruiker die is gekoppeld aan het apparaat.
LastLoggedOnUserId	Tekenreeks	Unieke id voor de gebruiker die zich het laatst heeft aangemeld bij het apparaat.
InCompliancePeriodUntilDateTime	Datum/tijd	De datum/tijd waarop de respijtperiode voor apparaatnaleving verloopt
DeviceCategoryId	Tekenreeks	Weergavenaam van apparaatcategorie. De standaardwaarde is een lege tekenreeks.
LastSeenDateTime	Tekenreeks	De datum en tijd waarop het apparaat voor het laatst verbinding heeft gemaakt met Intune.
Ownership	Tekenreeks	Eigendom van het apparaat.

Met apparaatentiteit kunt u verwijzen naar het apparaat dat is gekoppeld aan een resulterende rij zonder dat u een afzonderlijke query hoeft te schrijven om deze samen te voegen. In wezen fungeert het als een automatische join om apparaatgegevens op te nemen in uw queryresultaten.

De apparaatentiteit wordt automatisch toegevoegd aan elke andere entiteit voor gebruiksgemak. De apparaatentiteit is de eerste kolom in de queryresultaten, tenzij de query het retourtype bijwerken door gebruik te maken van operators zoals , projectsummarizeof distinct.

Als u apparaat zelf gebruikt in een query, wordt geparseerd naar Device.DeviceId. In de standaard geretourneerde kolom Apparaat wordt de DeviceId vertaald naar DeviceName, zodat apparaten gemakkelijker kunnen worden geïdentificeerd. Naar de apparaatentiteit en de bijbehorende eigenschappen kan ook worden verwezen in query's door te verwijzen naar Apparaat. [Eigenschap Invoegen].

De volgende query retourneert alle DiskDrive-informatie voor alle apparaten met serienummer 123:

DiskDrive
where Device.SerialNumber = 123

De volgende query projecteert de eigenschappen Apparaat-id en Fabrikant van de entiteit DiskDrive:

DiskDrive | project Device.DeviceId, Manufacturer

Hoewel de entiteit Apparaat die wordt weergegeven als de eerste kolom standaard wordt weergegeven als apparaatnamen wordt weergegeven met apparaat op zichzelf in een query, wordt geparseerd naar Device.DeviceId. Deze query retourneert resultaten geordend op de DeviceID, niet op DeviceName:

MemoryInfo | order by Device

Op dezelfde manier retourneert deze query geen resultaten, tenzij de apparaat-id Desktop123 is. Er wordt geen query uitgevoerd op de apparaatnaam:

Cpu | where Device == "Desktop123"

Gebruik het volgende voorbeeld om een query uit te voeren op de apparaatnaam:

Cpu | where Device.DeviceName == 'Desktop123"

Bekende beperkingen

• Als u de entiteit Apparaat in aggregatiefuncties gebruikt, wordt een rode onderstreping weergegeven. De query kan echter nog steeds worden uitgevoerd en kan resultaten retourneren zoals verwacht. De volgende query toont bijvoorbeeld een rode onderstreping onder Apparaat , maar wordt nog steeds uitgevoerd:

  Cpu | summarize max(Device) by Manufacturer.
  

• Query's met een joinoperator, $left en $right parameters tonen een rode onderstreping onder $left en $right. De query kan echter nog steeds worden uitgevoerd en retourneert resultaten zoals verwacht.

• Eén query kan maximaal drie joinoperators bevatten. Query's met meer joins mislukken.

• Er wordt een maximum van ~50.000 records geretourneerd voor een query.

• Er kunnen maximaal 10 query's per minuut worden ingediend. Alle andere query's binnen dezelfde minuut mislukken.

• Er kunnen maximaal 1000 query's per maand worden ingediend.

• Negatieve waarden voor de parameter amounts van de functie datetime_add() worden niet ondersteund.

• Als u verwijst naar een variabele die is samengevat door een aggregatiefunctie, treedt er een fout op. Als u de variabele expliciet een naam geeft, kan de query opnieuw worden uitgevoerd. Bijvoorbeeld de query Apparaat | summarize dcount(DeviceId) | order by dcount_DeviceId mislukt. Apparaat | summarize DCountDeviceIdRename=dcount(DeviceId) | order by DCountDeviceIdRename slaagt.