MS Graph设备查询$filter失效及DevicePhysicalId更新需求

一、$filter失效的核心原因与修复 #

你遇到的$filter不生效、返回所有设备的问题，大概率是PowerShell对URL中$符号的解析导致的。PowerShell里$是变量标识符，用双引号包裹URL时，$filter会被当作未定义的变量处理，最终发送的请求URL丢失了过滤参数，所以返回了全量设备。

修复方法有两种：

• 方法1：用单引号包裹URL，避免PowerShell解析$符号：

$uri = 'https://graph.microsoft.com/v1.0/devices?$filter=DeviceId eq ''11111111-1111-1111-1111-111111111111'''

注意单引号内部的单引号需要用两个连续单引号转义。

• 方法2：转义URL中的$符号，在$前加PowerShell的转义符`（反引号）：

$uri = "https://graph.microsoft.com/v1.0/devices?`$filter=DeviceId eq '11111111-1111-1111-1111-111111111111'"

另外还要注意两个细节：

• DeviceId是区分大小写的，确保你传入的ID和设备实际的DeviceId大小写完全一致；
• 确认应用的委托权限已正确授予且已同意，需要至少Device.Read.All或Directory.Read.All权限才能读取设备列表并过滤。

二、全量设备列表的处理方案（备用） #

如果过滤问题暂时无法解决，可以先获取全量设备，再本地筛选目标设备，然后通过objectId更新属性：

1. 分页获取全量设备（Graph API默认一页返回100条数据，需处理分页）：

$allDevices = @()
$uri = 'https://graph.microsoft.com/v1.0/devices'
do {
    $response = Invoke-WebRequest -Method GET -Uri $uri -ContentType "application/json" -Headers @{Authorization = "Bearer $token"} -UseBasicParsing -ErrorAction Stop
    $devices = $response.Content | ConvertFrom-Json
    $allDevices += $devices.value
    $uri = $devices.'@odata.nextLink'
} while ($uri)

2. 根据DeviceId筛选目标设备并更新属性：

$targetDevice = $allDevices | Where-Object { $_.DeviceId -eq '11111111-1111-1111-1111-111111111111' }
if ($targetDevice) {
    $updateUri = "https://graph.microsoft.com/v1.0/devices/$($targetDevice.id)"
    $body = @{ DevicePhysicalId = "新的物理ID值" } | ConvertTo-Json
    Invoke-WebRequest -Method PATCH -Uri $updateUri -ContentType "application/json" -Headers @{Authorization = "Bearer $token"} -Body $body -UseBasicParsing -ErrorAction Stop
    Write-Host "设备属性更新成功"
} else {
    Write-Host "未找到指定DeviceId的设备"
}

注意更新设备属性需要Device.ReadWrite.All或Directory.ReadWrite.All的委托权限。

内容的提问来源于stack exchange，提问作者c4os