什么是Locate your position on modern Windows
这款工具是一个专为现代 Windows 系统设计的 PowerShell 脚本，用于通过系统内置的 WinRT Location API 获取当前主机的精确地理位置。它完全依赖原生 Windows Runtime 组件，无需调用任何外部地理定位服务或 API 密钥，也无需浏览器支持或额外安装依赖项。脚本利用 `Windows.Devices.Geolocation.Geolocator` 类发起异步位置请求，并通过反射机制将 WinRT 异步操作转换为 .NET Task，从而实现同步等待结果并输出结构化数据。整个过程在用户态运行，不需要管理员权限，非常适合自动化脚本、远程监控或本地日志记录等场景。由于其基于操作系统底层能力，定位精度高度依赖于设备硬件：若设备配有 GPS 模块，可获得米级精度；若仅依赖 Wi-Fi 三角定位，则通常在 1–3 公里范围内；当两者均不可用时，系统会回退到 IP 地址估算，此时误差可能超过 10 公里。该脚本兼容 Windows 10 及以上版本，且必须在 PowerShell 5.1（即传统 powershell.exe）环境中执行，不支持 PowerShell Core（pwsh）。
核心功能特点
- 使用 Windows 原生 WinRT Geolocation API 实现地理位置获取，无需第三方服务或网络请求
- 自动适配多种定位源：GPS、Wi-Fi 三角定位或 IP 地址回退，根据硬件条件智能选择最优方式
- 输出标准 JSON 格式结果，包含经纬度、精度半径和时间戳，便于程序解析和集成
- 纯 PowerShell 脚本实现，零依赖、无需安装、无需管理员权限即可运行
- 通过反射调用 System.WindowsRuntimeSystemExtensions.AsTask 桥接 WinRT 异步模型与 .NET 任务模型
适用场景
该工具特别适合需要在无网络 API 调用的前提下，快速获取本地设备物理位置的场景。例如，在企业内部部署的资产管理系统中，管理员可通过此脚本批量检测多台终端的实际接入点位置，辅助网络拓扑规划或安全审计。对于远程运维人员而言，当无法通过 IP 地址判断用户所在城市时，该脚本可作为轻量级探针，帮助确认故障设备的实际部署环境。此外，在开发基于位置的服务（LBS）原型或自动化测试流程中，开发者可以利用其输出模拟不同地理位置的数据输入，而无需手动切换真实环境。由于脚本直接调用操作系统级接口，响应速度快、隐私风险低，因此也适用于对数据敏感度要求较高的合规性检查任务。需要注意的是，其准确性受限于设备硬件和系统设置，因此在关键业务决策前建议结合其他验证手段。