如何使用 Microsoft Graph Explorer 工具

Microsoft Graph Explorer 是最方便、最简单的工具之一，可帮助您更好地理解 Graph API，并通过弥合开发人员与开发人员之间的差距，使用 PowerShell 开发脚本。美国管理员。该工具不仅限于 PowerShell，它仍然被使用诸如 C#、等语言的软件开发人员大量使用>开始，Java 和JavaScript。

在本教程中，我将引导您开始使用 Microsoft Graph Explorer 工具，以帮助您从旧模块迁移到 Microsoft Graph PowerShell例如 AzureAD 或 MSOL。

如何登录 Microsoft Graph 浏览器

首先打开您首选的 Web 浏览器并导航到下面的 Microsoft Graph Explorer 链接：

https://developer.microsoft.com/en-us/graph/graph-explorer

要登录该工具并将其连接到您的租户，请单击页面右上角的个人资料图标，这将加载一个弹出窗口，提示您登录租户。

出现提示时，使用全局管理员凭据登录。原因是，当您使用该工具时，您需要有权同意 Azure AD 中的 Graph Explorer 应用程序的不同权限，并且需要全局管理员权限才能同意这些权限。

登录后，一个名为 Graph Explorer 的 Entperise 应用程序将在 Azure Active Directory 中注册。您可以登录https://entra.microsoft.com，展开应用程序，然后展开企业应用程序。

您可能会注意到，Graph Explorer 应用程序的应用程序 ID 在所有 Microsoft 租户中都是相同的：de8bc8b5-d9f9-48b1-a8ad-b748da725064。这会带来一些安全风险，我们将在本书后面讨论。

工具导航

微软在这个工具的用户体验方面做得很好，一旦你学会了它的方法，导航就会快速、简单和直观。您将在下面找到 Microsoft Graph Explorer 工具的屏幕截图，其中突出显示了所有感兴趣的点：

示例查询选项卡为您提供了来自 Microsoft 的预设和简单查询列表，以帮助您获取、创建修改资源。

资源选项卡提供了您可以在 Microsoft Graph 中查询的所有可用资源的列表。您还可以在 Graph v1.0 和 Beta 版本之间切换。这可能会影响资源的可用性。

历史记录选项卡为您提供过去 30 天内使用 Graph Explorer 工具进行的所有查询的列表。

在页面的其余部分（上图右侧的所有内容），您将找到用于创建和处理请求以及管理响应的所有工具和信息。

示例查询选项卡为您提供了来自 Microsoft 的预设和简单查询列表，以帮助您获取、创建修改资源。

示例查询选项卡为您提供了来自 Microsoft 的预设和简单查询列表，以帮助您获取、创建修改资源。

示例查询选项卡为您提供了来自 Microsoft 的预设和简单查询列表，以帮助您获取、创建修改资源。

示例查询选项卡为您提供了来自 Microsoft 的预设和简单查询列表，以帮助您获取、创建修改资源。

示例查询选项卡为您提供了来自 Microsoft 的预设和简单查询列表，以帮助您获取、创建修改资源。

示例查询选项卡为您提供了来自 Microsoft 的预设和简单查询列表，以帮助您获取、创建修改资源。

示例查询选项卡为您提供了来自 Microsoft 的预设和简单查询列表，以帮助您获取、创建修改资源。

示例查询选项卡为您提供了来自 Microsoft 的预设和简单查询列表，以帮助您获取、创建修改资源。

示例查询选项卡为您提供了来自 Microsoft 的预设和简单查询列表，以帮助您获取、创建修改资源。

示例查询选项卡为您提供了来自 Microsoft 的预设和简单查询列表，以帮助您获取、创建修改资源。

示例查询选项卡为您提供了来自 Microsoft 的预设和简单查询列表，以帮助您获取、创建修改资源。

示例查询选项卡为您提供了来自 Microsoft 的预设和简单查询列表，以帮助您获取、创建修改资源。

使用示例查询

示例查询是 Microsoft 为您提供的易于使用且方便的查询，可帮助您开始使用 Graph Explorer 工具。虽然并未为所有资源提供示例，但我们提供了常用资源列表供您查询。

假设您想要获取组织中所有群组的列表，您可以使用示例查询来实现。首先选择示例查询选项卡，然后搜索组。

展开组选项卡并选择列出我组织中的所有群组。

您会注意到查询框会自动填写所选请求的信息。完成后，点击运行查询查看结果。

从响应预览选项卡中，您可以查看查询的响应，其中包括您组织中所有群组的列表。

同意权限

有时，您可能会发现，当您尝试运行查询时，会看到红色警告横幅，并且响应预览中出现错误，如下所示。

{
    "error": {
        "code": "AccessDenied",
        "message": "You cannot perform the requested operation, required scopes are missing in the token.",
        "innerError": {
            "date": "2023-06-13T15:17:39",
            "request-id": "6e3bbe1f-270f-4030-b6e0-ed13e25e4902",
            "client-request-id": "8791dfff-cf8a-60ec-ad16-1202022a920e"
        }
    }
}

在本例中，我尝试列出组织中的所有条件访问策略，但是，错误指出我没有完成此请求所需的权限范围。

红色警告横幅为我们提供了类似的信息，但它也为我们提供了解决问题的建议。

为了完成此请求，我们需要征得全局管理员的同意，向 Azure AD 中的 Graph Explorer 应用程序授予必要的 Graph 权限。为此，请选择修改权限选项卡。您将看到页面上已列出必要的权限。点击相关权限旁边的同意，然后按照屏幕上的步骤授予对所请求权限的同意。

完成后，重新运行查询，响应应返回 OK。

您在此处同意的权限将永久同意 Graph Explorer 工具，并且在注销并重新登录后仍然可用。请按照第 4 章中的步骤了解如何删除权限您之前已同意。

检索 PowerShell 代码

Graph Explorer 工具的最佳功能之一是它可以以简单的方式将自定义查询转换为 PowerShell 代码，然后您可以将其合并到脚本中。它还可以将查询转换为其他语言，例如 C#、Go、Java 和 Javascript。

要检索查询的等效 PowerShell 代码，请首先运行查询并确认输出符合预期。这是我的例子：

https://graph.microsoft.com/v1.0/users?$count=true&$filter=Department eq 'Finance'&$orderBy=displayName&$select=id,displayName,department

此查询将筛选财务部门的所有用户，然后按 DisplayName 属性对结果进行排序，同时仅返回用户的 ID、DisplayName 和部门值。

从屏幕底部选择代码片段。

然后选择PowerShell选项卡显示 PowerShell 代码：

使用 PowerShell 窗口右上角的 复制按钮复制您的 PowerShell 代码：

结果如下：

Import-Module Microsoft.Graph.Users

Get-MgUser -CountVariable CountVar -Filter "Department eq 'Finance'" -Sort "displayName" -Property "id,displayName,department" -ConsistencyLevel eventual 

遗憾的是，它唯一不会在 PowerShell 代码中显示的信息是Connection-MgGraph方法和权限范围。因此，请不要忘记，如果您在 PowerShell 中运行此代码，您之前在 Graph Explorer 工具中同意的权限将不适用。您必须在执行 Connect-MgGraph 命令期间同意权限或应用此权限提前到 Azure AD 应用程序。