PowerShell
AI GraphQuery Wrapper
AI-GraphQuery-Wrapper.ps1
PowerShell
AI-GraphQuery-Wrapper.ps1
<#
.SYNOPSIS
AI-GraphQuery-Wrapper - Translates natural language to Microsoft Graph OData filters.
.DESCRIPTION
<!-- library-status:start -->
Prüfstatus: Ungeprüft
Aus dem bestehenden GitHub-Bestand übernommen; fachliche und Tenant-Abnahme ausstehend.
<!-- library-status:end -->
This script leverages an LLM to convert human-readable requests into precise
OData filter strings for Microsoft Graph API calls.
Example Request: "All HP laptops that haven't synced in 30 days"
Resulting Filter: "manufacturer eq 'HP' and lastSyncDateTime lt 2026-06-15T00:00:00Z"
#>
[CmdletBinding()]
param (
[Parameter(Mandatory=$true)]
[string]$Query,
[Parameter(Mandatory=$false)]
[string]$ApiKey = "YOUR_API_KEY",
[Parameter(Mandatory=$false)]
[string]$TargetEndpoint = "devices"
)
process {
Write-Host "[INFO] Analyzing request: '$Query'..." -ForegroundColor Cyan
$SystemPrompt = "You are a Microsoft Graph API expert. Translate the user's natural language request into a valid OData `$filter` string for the endpoint '$TargetEndpoint'. Return ONLY the filter string. No explanation, no markdown, no quotes. Example: 'manufacturer eq 'Dell' and complianceState eq 'noncompliant'"
$Body = @{
model = "gpt-4o"
messages = @(
@{ role = "system"; content = $SystemPrompt },
@{ role = "user"; content = $Query }
)
temperature = 0
} | ConvertTo-Json
try {
$Response = Invoke-RestMethod -Method Post -Uri "https://api.openai.com/v1/chat/completions" `
-Headers @{ "Authorization" = "Bearer $ApiKey"; "Content-Type" = "application/json" } `
-Body $Body
$ODataFilter = $Response.choices[0].message.content.Trim()
Write-Host "[SUCCESS] Generated Filter: $ODataFilter" -ForegroundColor Green
Write-Host "[EXEC] Fetching data from Graph..." -ForegroundColor Gray
$Results = Get-MgDevice -Filter $ODataFilter -All
return $Results
}
catch {
Write-Error "Failed to translate or execute query: $($_.Exception.Message)"
}
}
Wir verwenden Cookies, um die Website bereitzustellen, ihre Nutzung statistisch zu messen und Werbung einzublenden. Notwendige Cookies sind immer aktiv. Statistik und Werbung nutzen wir nur mit deiner Einwilligung. Verantwortlich: Simeone Cirillo, c/o Impressumservice Dein-Impressum, Stettiner Straße 41, 35410 Hungen. Du entscheidest freiwillig; Ablehnen ist genauso einfach wie Zustimmen. Deine Auswahl kannst du jederzeit über „Einstellungen“ ändern. Anbieter, Cookie-Namen und Speicherdauer stehen in der Datenschutzerklärung und im Impressum. Datenschutzerklärung
Cookie-Einstellungen