Enhetsfråga för flera enheter

Obs!

Den här funktionen är tillgänglig som ett Intune tillägg. Mer information finns i Använda Intune Suite-tilläggsfunktioner.

Med enhetsfråga för flera enheter kan du få omfattande insikter om hela din enhetsflotta med hjälp av Kusto-frågespråk (KQL) för att köra frågor mot insamlade inventeringsdata för dina enheter.

Innan du börjar

• Kontrollera att din miljö uppfyller alla krav.

Ytterligare krav för enhetsfråga för flera enheter:

Krav för enhetsplattform

Enhetsfråga för flera enheter stöder:

• Windows
• Android
  • Företagsägda Android Enterprise-enheter (COSU)
  • Fullständigt hanterad Android Enterprise-företagsägd (COBO)
  • Android Enterprise företagsägd arbetsprofil (COPE)
• Apple
  • iOS/iPadOS
  • macOS

Krav för enhetskonfiguration

Enhetsfråga för flera enheter stöder enheter som är:

• Hanteras av Intune och markeras som företagsägd
• Windows-enheter måste ha en princip för egenskapskatalog distribuerad till dem för att samla in inventeringsdata.
  För iOS/iPadOS, Android och macOS samlas data in automatiskt och en separat egenskapskatalogprincip behöver inte distribueras.

Rollkrav

Om du vill använda enhetsfråga för flera enheter använder du ett konto med minst en av följande roller:

• Supportansvarig
• Anpassad roll som innehåller:
  • Behörigheten Hanterade enheter/Fråga
  • Behörigheter som ger insyn i och åtkomst till hanterade enheter i Intune (till exempel organisation/läsning, hanterade enheter/läsning)

Använda enhetsfråga för flera enheter

1. I Microsoft Intune administrationscenter väljer duEnhetsenhetsfråga>.
2. Ange en fråga i frågerutan med de egenskaper som stöds och operatorer som stöds.
3. Välj Kör för att köra frågan.
4. Resultaten visas i området Resultat på fliken .
   • Om du bara vill köra en del av frågan, eller om du har flera frågor i frågefönstret och bara vill köra en, kan du markera frågan som du vill köra och välja Kör. Endast den frågan körs.

Du kan expandera vyn till vänster om du vill se alla egenskaper som kan efterfrågas. Välj vilken som helst som ska fyllas i i frågan. Du kan markera och dra kanterna på både vänster sida och frågefönstret för att göra eventuella justeringar.

När du har kört en fråga väljer du Exportera för att spara resultat i en .CSV fil. Du kan exportera alla kolumner i frågeresultatet eller bara de kolumner som du väljer. Du kan exportera upp till 50 000 resultat till en fil.

Mer information om Kusto-frågespråk finns i Läs mer om Kusto-frågespråk.

Tips

Använd Copilot i Intune för att generera KQL-frågor för enhetsfrågor med hjälp av begäranden på naturligt språk. Mer information finns i Fråga med Copilot i enhetsfråga.

Exempelfrågor

För att hjälpa dig att komma igång finns några exempelfrågor i det här avsnittet. Om du vill komma åt exempelfrågorna expanderar du avsnittet exempelfrågor under sidan Komma igång och väljer den som du vill lägga till i frågefönstret. I följande avsnitt visas en lista över exempelfrågor.

De främsta processorerna efter antal kärnor

Den här frågan visar de fem främsta processorerna sorterade efter antal kärnor.

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

Enheter med oskyddade diskar

Den här frågan visar enheter med okrypterade diskar.

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

Arm64-enheter

Den här frågan visar en lista över alla enheter med en ARM64-processor.

Cpu | where Architecture == "ARM64"

Antal enheter efter processorarkitektur

Den här frågan innehåller en sammanfattning av enheter efter CPU-arkitektur.

Cpu| summarize DeviceCount=count() by Architecture

De främsta enheterna efter batterikapacitet

Den här frågan visar de 10 främsta enheterna med fulladdad batterikapacitet.

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

Minnesinformation för enheter

Den här frågan visar enheter med fysiskt och virtuellt minne i GB.

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

Antal enheter efter operativsystemversion

Den här frågan innehåller en sammanfattning av enheter efter operativsystemversion.

OsVersion| summarize DevicesCount = count() by OsVersion

Information om enheters bios

Den här frågan listar enheter som baseras på BIOS-tillverkare.

BiosInfo| where Manufacturer contains "Microsoft"

TPM-inaktiverade enheter

Den här frågan visar en lista över enheter som har TPM inaktiverat.

Tpm | where Enabled != true

Operatorer som stöds

Enhetsfrågan stöder endast en delmängd av de operatorer som stöds i Kusto-frågespråk (KQL). Följande operatorer stöds för närvarande:

Tabelloperatorer

Tabelloperatorer kan användas för att filtrera, sammanfatta och transformera dataströmmar. Följande operatorer stöds:

Tabelloperatorer	Beskrivning
count	Returnerar en tabell med en enda post som innehåller antalet poster.
distinct	Skapar en tabell med en distinkt kombination av de angivna kolumnerna i indatatabellen.
join	Sammanfoga raderna i två tabeller för att skapa en ny tabell genom att matcha raden för samma enhet. Endast kopplingstyperna innerunique, Leftouter, Fullouter, Rightouteroch inner stöds. Om du skriver in en annan kopplingstyp än de som stöds ignoreras de. Kopplingsinstruktioner stöder on syntax om de är anslutna till Device eller Device.Deviceid. Gemensam syntax för koppling är LeftEntity | join [hints] (RightEntity) på Villkor. Mer information finns i Delta i dokumentationen.
order by	Sortera raderna i indatatabellen i ordning efter en eller flera kolumner.
project	Välj de kolumner som ska inkluderas, byt namn på eller släpp och infoga nya beräknade kolumner.
take	Återgå till det angivna antalet rader.
top	Returnerar de första N posterna sorterade efter de angivna kolumnerna.
where	Filtrera en tabell till den delmängd av rader som uppfyller ett predikat.
summarize	skapar en tabell som aggregerar innehållet i indatatabellen.

Skalära operatorer

Skaläroperatorer kan användas för att utföra åtgärder på enskilda värden. Följande operatorer stöds:

Operatörer	Beskrivning	Exempel
==	Lika	1 == 1, 'aBc' == 'AbC'
!=	Inte lika med	1 != 2, 'abc' != 'abcd'
<	Mindre	1 < 2, 'abc' < 'DEF'
>	Större	2 > 1, 'xyz' > 'XYZ'
<=	Mindre eller lika med	1 <= 2, 'abc' <= 'abc'
>=	Större eller lika med	2 >= 1, 'abc' >= 'ABC'
+	Addera	2 + 1, now() + 1d
-	Subtrahera	2 - 1, now() - 1h
*	Multiplicera	2 * 2
/	Dela	2 / 1
%	Modulo	2 % 1
like	LHS innehåller en matchning för RHS	'abc' like '%B%'
contains	RHS inträffar som en delmängd av LHS	'abc' contains 'b'
!contains	RHS förekommer inte i LHS	'team' !contains 'i'
startswith	RHS är en inledande delmängd av LHS	'team' startswith 'tea'
!startswith	RHS är inte en inledande delmängd av LHS	'abc' !startswith 'bc'
endswith	RHS är en avslutande delmängd av LHS	'abc' endswith 'bc'
!endswith	RHS är inte en avslutande delmängd av LHS	'abc' !endswith 'a'
and	Sant om och endast om RHS och LHS är sanna	(1 == 1) and (2 == 2)
or	Sant om och endast om RHS eller LHS är sant	(1 == 1) or (1 == 2)

Sammansättningsfunktioner

Sammansättningsfunktioner kan användas för att sammanfatta data. Följande funktioner stöds:

Funktion	Beskrivning
avg()	Returnerar medelvärdet av värdena i hela gruppen
count()	Returnerar antalet poster per sammanfattningsgrupp
countif()	Returnerar antalet rader för vilka Predikat utvärderas till sant
dcount()	Returnerar antalet distinkta värden i gruppen
max()	Returnerar det maximala värdet i gruppen
maxif()	Returnerar det maximala värdet i gruppen för vilken Predikat utvärderas till sant
min()	Returnerar minimivärdet i gruppen
minif()	Returnerar det minsta värdet i gruppen för vilken Predikat utvärderas till sant
percentile()	Returnerar en uppskattning för den angivna percentilen för den närmaste rangordningen av populationen som definieras av Expr
sum()	Returnerar summan av värdena i gruppen
sumif()	Returnerar en summa av uttr som Predicate utvärderas till sant för

Skalärfunktioner

Skalärfunktioner kan användas för att utföra åtgärder på enskilda värden. Följande funktioner stöds:

Funktion	Beskrivning
ago()	Subtraherar det angivna tidsintervallet från den aktuella UTC-klocktiden.
bin()	Avrundar värden ned till ett antal datetime-flera av en viss lagerplatsstorlek.
case()	Utvärderar en lista över predikat och returnerar det första resultatuttrycket vars predikat är uppfyllt.
datetime_add()	Beräknar en ny datetime från en angiven datepart multiplicerat med ett angivet belopp som läggs till i en angiven datetime. Negativa värden för mängdparametern stöds inte.
datetime_diff()	Beräknar skillnaden mellan två datetime-värden.
iif()	Utvärderar det första argumentet och returnerar värdet för antingen det andra eller tredje argumentet beroende på om predikatet utvärderas till sant (andra) eller falskt (tredje).
indexof()	Rapporterar det nollbaserade indexet för den första förekomsten av en angiven sträng i indatasträngen.
isnotnull()	Utvärderar det enda argumentet och returnerar ett booleskt värde som anger om argumentet utvärderas till ett värde som inte är null.
isnull()	Utvärderar det enda argumentet och returnerar ett booleskt värde som anger om argumentet utvärderas till ett null-värde.
now()	Returnerar den aktuella UTC-klocktiden.
strcat()	Sammanfogar mellan 1 och 64 argument.
strlen()	Returnerar längden i tecken för indatasträngen.
substring()	Extraherar en delsträng från en källsträng från ett index till slutet av strängen.
tostring()	Konverterar indata till en strängrepresentation.

Egenskaper som stöds

Enhetsfrågan stöder följande entiteter. Mer information om vilka egenskaper som stöds för varje entitet finns i Intune Data Platform-schema.

• 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

Enhetsentitet

Enhetsfråga för flera enheter stöder en länkad entitet. Enhetsentiteten kan användas med alla andra entiteter som stöds. Enhetsentiteten stöder följande egenskaper:

Egenskap	Typ	Beskrivning
DeviceId	Sträng	Ett unikt ID som genereras av Intune som en del av enhetsregistreringen.
EntraDeviceId	Sträng	Unikt ID som genereras av Microsoft Entra som en del av Microsoft Entra registrering eller anslutning.
ManagementName	Sträng	Ett lätt igenkännbart enhetsnamn som endast används i Intune administrationscenter. Om du ändrar det här namnet ändras inte enhetsnamnet eller namnet i Företagsportal.
DeviceName	Sträng	Enhetens namn
SerialNumber	Sträng	Enhetens serienummer
Manufacturer	Sträng	Enhetens tillverkare
Model	Sträng	Enhetens modell
OSDescription	Sträng	Fullständig beskrivning av operativsystemets utgåva
OSVersion	Sträng	Versionen av operativsystemet på enheten
EnrollmentProfileName	Sträng	Namnet på registreringsprofilen som tilldelats enheten. Standardvärdet är en tom sträng som anger att ingen registreringsprofil har tilldelats till enheten.
EnrolledDateTime	Datetime	Datum och tid då enheten registrerades i Intune.
CertExpirationDateTime	Datetime	Rapporterar förfallodatum för enhetshanteringscertifikat.
EnrolledByUserId	Sträng	Unik identifierare för användaren som registrerade enheten
PrimaryUserId	Sträng	Unik identifierare för användaren som är associerad med enheten.
LastLoggedOnUserId	Sträng	Unik identifierare för den användare som senast loggade in på enheten.
InCompliancePeriodUntilDateTime	Datetime	DateTime när respitperioden för enhetsefterlevnad upphör att gälla
DeviceCategoryId	Sträng	Visningsnamn för enhetskategori. Standardvärdet är en tom sträng.
LastSeenDateTime	Sträng	Datum och tid då enheten senast anslöt till Intune.
Ownership	Sträng	Ägarskap för enheten.

Med enhetsentiteten kan du referera till den enhet som är associerad med en resulterande rad utan att behöva skriva en separat fråga för att koppla ihop dem. I princip fungerar det som en automatisk koppling för att inkludera enhetsinformation i dina frågeresultat.

Enhetsentiteten kopplas automatiskt till alla andra entiteter för enkel användning. Enhetsentiteten är den första kolumnen i de frågar efter resultat, såvida inte frågan uppdaterar returtypen med hjälp av operatorer som , projectsummarizeeller distinct.

Med hjälp av enheten själv i en fråga parsas till Device.DeviceId. I kolumnen Enhet som returneras som standard översätts DeviceId till DeviceName för enklare identifiering av enheter. Enhetsentiteten och dess egenskaper kan också refereras till i frågor genom att referera till Enhet. [Infoga egenskap].

Följande fråga returnerar all DiskDrive-information för alla enheter med serienummer 123:

DiskDrive
where Device.SerialNumber = 123

I följande fråga projiceras egenskaperna Enhets-ID och Tillverkare för entiteten DiskDrive:

DiskDrive | project Device.DeviceId, Manufacturer

Även om enhetsentiteten som visas som den första kolumnen som standard visas som enhetsnamn med hjälp av enheten själv i en fråga parsas till Device.DeviceId. Den här frågan returnerar resultat ordnade av DeviceID, inte efter DeviceName:

MemoryInfo | order by Device

På samma sätt returnerar den här frågan inga resultat om inte enhets-ID:t är Desktop123. Den frågar inte efter enhetsnamnet:

Cpu | where Device == "Desktop123"

Använd följande exempel för att fråga efter enhetsnamn:

Cpu | where Device.DeviceName == 'Desktop123"

Kända begränsningar

• Om du använder enhetsentiteten i aggregeringsfunktioner visas en röd understrykning. Frågan kan dock fortfarande köras och returnera resultat som förväntat. Följande fråga visar till exempel en röd understrykning under Enhet men körs fortfarande:

  Cpu | summarize max(Device) by Manufacturer.
  

• Frågor med en kopplingsoperator, $left- och $right parametrar visar en röd understrykning under $left och $right. Frågan kan dock fortfarande köras och returnerar resultat som förväntat.

• En enskild fråga kan innehålla högst tre kopplingsoperatorer. Frågor med fler kopplingar misslyckas.

• Högst ~50 000 poster returneras för en fråga.

• Högst 10 frågor kan skickas per minut. Andra frågor inom samma minut misslyckas.

• Högst 1 000 frågor kan skickas per månad.

• Negativa värden för parametern amounts för funktionen datetime_add() stöds inte.

• Om du refererar till en variabel som har sammanfattats av en aggregeringsfunktion genereras ett fel. Genom att uttryckligen namnge variabeln kan frågan lyckas igen. Till exempel frågan Enhet | summarize dcount(DeviceId) | order by dcount_DeviceId kommer att misslyckas. Enhet | summarize DCountDeviceIdRename=dcount(DeviceId) | order by DCountDeviceIdRename lyckas.