Microsoft 365 IP 地址和 URL Web 服务

Microsoft 365 IP 地址和 URL Web 服务可帮助你更好地识别和区分Microsoft 365 网络流量，从而更轻松地评估、配置和及时了解更改。此基于 REST 的 Web 服务将取代自 2018 年 10 月 2 日开始逐步停止使用的旧版 XML 可下载文件。

作为客户或网络外围设备供应商，你可以针对Microsoft 365 IP 地址和 FQDN 条目的 Web 服务进行构建。你可以使用以下 URL 直接访问 Web 浏览器中的数据：

对于防火墙和代理服务器的 Microsoft 365 URL 和 IP 地址范围页上的数据，请使用 https://endpoints.office.com/endpoints/worldwide。
若要获取自 2018 年 7 月这项 Web 服务首次推出以来的所有最新变更，请使用 https://endpoints.office.com/changes/worldwide/0000000000。

作为客户，你可以使用这项 Web 服务：

更新 PowerShell 脚本以获取Microsoft 365 终结点数据并修改网络设备的任何格式。
根据此类信息更新已部署到客户端计算机的 PAC 文件。

作为网络外围设备供应商，你可以使用这项 Web 服务：

创建并测试设备软件，以下载自动配置列表。
检查当前版本。
获取最新变更。

注意

如果使用 Azure ExpressRoute 连接到 Microsoft 365，请查看 Azure ExpressRoute for Microsoft 365，以熟悉通过 Azure ExpressRoute 支持的 Microsoft 365 服务。另请参阅文章Microsoft 365 个 URL 和 IP 地址范围，了解Microsoft 365 应用程序的哪些网络请求需要 Internet 连接。这有助于更好地配置外围安全设备。

有关更多信息，请参阅：

通用参数

下面两个参数是所有 Web 服务方法的通用参数：

format=<JSON |CSV> - 默认情况下，返回的数据格式为 JSON。使用此可选参数返回采用逗号分隔值 (CSV) 格式的数据。
ClientRequestId=<guid> - 为客户端关联生成的必需 GUID。为调用 Web 服务的每台计算机生成唯一的 GUID（此页面上包含的脚本将为你生成 GUID）。请勿使用以下示例中显示的 GUID，因为 Web 服务将来可能会阻止这些 GUID。 GUID 格式为 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx，其中 x 表示十六进制数。

若要生成 GUID，你可以使用 New-Guid PowerShell 命令，或使用在线 GUID 生成器等在线服务。

版本 Web 方法

Microsoft在每个月初更新Microsoft 365 IP 地址和 FQDN 条目。由于支持事件、安全更新或其他作要求，有时会发布带外更新。

为每个已发布实例的数据分配一个版本号，版本 Web 方法使你能够为每个Microsoft 365 服务实例的最新版本检查。我们建议每小时检查版本的次数不要超过一次。

版本 Web 服务的参数如下：

AllVersions=<true | false> - 默认情况下，返回的版本为最新版本。包括此可选参数，以请求首次发布 Web 服务之后的所有已发布版本。
Format=<JSON |CSV |RSS> - 除了 JSON 和 CSV 格式外，版本 Web 方法还支持 RSS。可以将此可选参数与参数一起使用 AllVersions=true ，以请求可与 Outlook 或其他 RSS 读取器一起使用的 RSS 源。
Instance=<全球 |中国 |USGovDoD |USGovGCCHigh> - 此可选参数指定要返回其版本的实例。如果圣罗，则会返回所有实例。有效实例包括：Worldwide、China、USGovDoD、USGovGCCHigh。

版本 Web 方法不受速率限制，并且永远不会返回 429 HTTP 响应代码。对版本 Web 方法的响应包括一个缓存控制标头，它建议将数据缓存 1 小时。版本 Web 方法的结果可以是一条记录，也可以是一组记录。每条记录均包含以下元素：

instance - Microsoft 365 服务实例的短名称。
latest - 指定实例终结点的最新版本。
versions - 指定实例的所有早期版本的列表。仅当参数为 true 时， AllVersions 才会包含此元素。

版本 Web 方法示例

示例 1 请求 URI：https://endpoints.office.com/version?ClientRequestId=b10c5ed1-bad1-445f-b386-b919946339a7

此 URI 返回每个 Microsoft 365 服务实例的最新版本。示例结果：

[
 {
  "instance": "Worldwide",
  "latest": "2018063000"
 },
 {
  "instance": "USGovDoD",
  "latest": "2018063000"
 },
 {
  "instance": "USGovGCCHigh",
  "latest": "2018063000"
 },
 {
  "instance": "China",
  "latest": "2018063000"
 }
]

重要

这些 URI 中 ClientRequestID 参数的 GUID 只是一个示例。若要试用 Web 服务 URI，请生成自己的 GUID。 Web 服务将来可能会阻止这些示例中所示的 GUID。

示例 2 请求 URI：https://endpoints.office.com/version/Worldwide?ClientRequestId=b10c5ed1-bad1-445f-b386-b919946339a7

此 URI 返回指定 Microsoft 365 服务实例的最新版本。示例结果：

{
 "instance": "Worldwide",
 "latest": "2018063000"
}

示例 3 请求 URI：https://endpoints.office.com/version/Worldwide?Format=CSV&ClientRequestId=b10c5ed1-bad1-445f-b386-b919946339a7

此 URI 以 CSV 格式显示输出。示例结果：

instance,latest
Worldwide,2018063000

示例 4 请求 URI：https://endpoints.office.com/version/Worldwide?AllVersions=true&ClientRequestId=b10c5ed1-bad1-445f-b386-b919946339a7

此 URI 显示已针对 Microsoft 365 全球服务实例发布的所有早期版本。示例结果：

{
  "instance": "Worldwide",
  "latest": "2018063000",
  "versions": [
    "2018063000",
    "2018062000"
  ]
}

示例 5 RSS 源 URI： https://endpoints.office.com/version/worldwide?clientRequestId=b10c5ed1-bad1-445f-b386-b919946339a7&allVersions=true&format=RSS

此 URI 显示已发布版本的 RSS 源，其中包含指向每个版本更改列表的链接。示例结果：

<?xml version="1.0" encoding="ISO-8859-1"?>
<rss version="2.0" xmlns:a10="https://www.w3.org/2005/Atom">
<channel>
<link>https://aka.ms/o365ip</link>
<description/>
<language>en-us</language>
<lastBuildDate>Thu, 02 Aug 2018 00:00:00 Z</lastBuildDate>
<item>
<guid isPermaLink="false">2018080200</guid>
<link>https://endpoints.office.com/changes/Worldwide/2018080200?singleVersion&clientRequestId=b10c5ed1-bad1-445f-b386-b919946339a7</link> <description>Version 2018080200 includes 2 changes. IPs: 2 added and 0 removed.</description>
<pubDate>Thu, 02 Aug 2018 00:00:00 Z</pubDate>
</item>

终结点 Web 方法

终结点 Web 方法返回构成 Microsoft 365 服务的 IP 地址范围和 URL 的所有记录。应始终使用最新的终结点 Web 方法数据来进行网络设备配置。 Microsoft 会在发布新增内容前 30 天提前发出通知，以便你有时间更新访问控制列表和代理服务器跳过列表。建议你仅在版本 Web 方法表示存在新的数据版本时才再次调用终结点 Web 方法。

终结点 Web 方法的参数如下：

ServiceAreas=<通用 |Exchange |SharePoint |Skype> - 以逗号分隔的服务区域列表。有效项为 Common、 Exchange、 SharePoint和 Skype。由于 Common 服务区域项是所有其他服务区域的先决条件，因此 Web 服务始终包含它们。如果未包含此参数，则返回所有服务区域。
TenantName=<tenant_name> - Microsoft 365 租户名称。 Web 服务采用所提供的名称，并将其插入到包含租户名称的 URL 中。如果未提供租户名称，则 URL 的这些部分具有通配符 (*) 。
NoIPv6=<true | false> - 如果网络中未使用 IPv6，请将值设置为 true 以从输出中排除 IPv6 地址。
Instance=<全球 |中国 |USGovDoD |USGovGCCHigh> - 此参数指定从中返回终结点的实例。有效实例为： Worldwide、 China、 USGovDoD和 USGovGCCHigh。

如果从同一客户端 IP 地址多次调用终结点 Web 方法，则可能会收到 HTTP 响应代码 429 (Too Many Requests)。如果收到此响应代码，请先等待 1 小时，然后再重复你的请求，或者为该请求生成新的 GUID。作为一般的最佳实践，仅在版本 Web 方法表示存在新的可用版本时才调用终结点 Web 方法。

终结点 Web 方法的结果是一组记录，每条记录均代表一个终结点集。每条记录均包含以下元素：

id - 终结点集的不可变 ID 号。
serviceArea - 属于的服务区域： Common、 Exchange、 SharePoint或 Skype。
urls - 终结点集的 URL。此为包含 DNS 记录的 JSON 数组。若为空白，将省略此元素。
tcpPorts - 终结点集的 TCP 端口。所有端口元素都格式化为端口的逗号分隔列表，或用短划线字符 (-) 分隔的端口范围。端口适用于相应类别的特定终结点集中的所有 IP 地址和所有 URL。若为空白，将省略此元素。
udpPorts - 此终结点集中 IP 地址范围的 UDP 端口。若为空白，将省略此元素。
ips - 与此终结点关联的 IP 地址范围，设置为与列出的 TCP 或 UDP 端口关联。 IP 地址范围的 JSON 数组。若为空白，将省略此元素。
category - 终结点集的连接类别。有效值是 Optimize、Allow 和 Default。如果在终结点 Web 方法输出中搜索特定 IP 地址或 URL 的类别，查询可能会返回多个类别。在这种情况下，请按照最高优先级类别的建议操作。例如，如果终结点同时出现在和 Allow中Optimize，则应遵循的要求Optimize。必填。
expressRoute - True 如果此终结点集通过 ExpressRoute 路由， False 则为。如果不是，则为。
必填 - True 如果需要此终结点集才能支持 Microsoft 365 的连接，则为。 False 如果此终结点集是可选的，则为。
注释 - 对于可选终结点，此文本介绍Microsoft 365 功能，如果无法在网络层访问此终结点集中的 IP 地址或 URL，则这些功能将不可用。若为空白，将省略此元素。

终结点 Web 方法示例

示例 1 请求 URI：https://endpoints.office.com/endpoints/Worldwide?ClientRequestId=b10c5ed1-bad1-445f-b386-b919946339a7

此 URI 获取所有工作负载的 Microsoft 365 全球实例的所有终结点。示例结果的输出摘录如下：

[
 {
  "id": 1,
  "serviceArea": "Exchange",
  "serviceAreaDisplayName": "Exchange Online",
  "urls":
   [
    "*.protection.outlook.com"
   ],
  "ips":
   [
    "2a01:111:f403::/48", "23.103.132.0/22", "23.103.136.0/21", "23.103.198.0/23", "23.103.212.0/22", "40.92.0.0/14", "40.107.0.0/17", "40.107.128.0/18", "52.100.0.0/14", "213.199.154.0/24", "213.199.180.128/26", "94.245.120.64/26", "207.46.163.0/24", "65.55.88.0/24", "216.32.180.0/23", "23.103.144.0/20", "65.55.169.0/24", "207.46.100.0/24", "2a01:111:f400:7c00::/54", "157.56.110.0/23", "23.103.200.0/22", "104.47.0.0/17", "2a01:111:f400:fc00::/54", "157.55.234.0/24", "157.56.112.0/24", "52.238.78.88/32"
   ],
  "tcpPorts": "443",
  "expressRoute": true,
  "category": "Allow"
 },
 {
  "id": 2,
  "serviceArea": "Exchange",
  "serviceAreaDisplayName": "Exchange Online",
  "urls":
   [
    "*.mail.protection.outlook.com"
   ],

此示例中请求的完整输出将包含其他终结点集。

示例 2 请求 URI：https://endpoints.office.com/endpoints/Worldwide?ServiceAreas=Exchange&ClientRequestId=b10c5ed1-bad1-445f-b386-b919946339a7

此示例仅为Exchange Online和依赖项获取 Microsoft 365 Worldwide 实例的终结点。

例如，输出 2 类似于示例 1，只是结果不包括 SharePoint 或 Skype for Business Online 的终结点。

变更 Web 方法

变更 Web 方法返回已发布的最新更新。这通常是上月的 IP 地址范围和 URL 变更。

终结点数据的最重要变更是新 URL 或 IP 地址。未能将 IP 地址添加到防火墙访问控制列表或代理服务器绕过列表的 URL 可能会导致该网络设备后面的 Microsoft 365 个用户中断。尽管有运营要求，新的终结点将在其配置使用之日的前 30 天提前发布到 Web 服务，以便你有时间更新访问控制列表和代理服务器跳过列表。

变更 Web 方法需要使用以下必填参数：

Version=<YYYYMMDDNN> - 所需的 URL 路由参数。此值为当前实施的版本。 Web 服务应返回自该版本之后发生的变更。格式为 YYYYMMDDNN，其中 NN 如果一天需要发布多个版本，则为递增的自然数，表示 00 给定日期的第一次更新。 Web 服务要求 version 参数正好包含 10 位数字。

变更 Web 方法受速率限制，与终结点 Web 方法受限于速率一样。如果收到 429 HTTP 响应代码，请先等待 1 小时，然后再重复你的请求，或者为该请求生成新的 GUID。

变更 Web 方法的结果是一组记录，每条记录均代表特定版本终结点中的变更。每条记录均包含以下元素：

id - 更改记录的不可变 ID。
endpointSetId - 已更改的终结点集记录的 ID。
disposition- 描述更改对终结点集记录执行的作。 change值为、 add或 remove。
impact - 并非所有更改都对每个环境都同样重要。此元素说明了相应变更对企业网络外围环境的预期影响。此属性仅包含在版本 2018112800 及更高版本的变更记录中。影响的选项包括：
- AddedIp - IP 地址已添加到 Microsoft 365，并将很快在服务上线。这表示需要更改防火墙或其他第 3 层网络外围设备。如果在开始使用之前未添加此项，可能会遇到服务中断。
- AddedUrl - URL 已添加到 Microsoft 365，并将很快在服务上线。这表示需要更改代理服务器或 URL 分析网络外围设备。如果在开始使用之前未添加此 URL，可能会遇到服务中断。
- AddedIpAndUrl - 同时添加了 IP 地址和 URL。这表示需要更改防火墙第 3 层设备、代理服务器或 URL 分析设备。如果在开始使用之前未添加此 IP/URL 对，可能会遇到服务中断。
- AddedSubstituteUrl - 以前因通配符而取消发布的 FQDN 现已发布，因为通配符 URL 已删除。此更改将立即生效。
- RemovedIpOrUrl - 至少从 Microsoft 365 中删除了一个 IP 地址或 URL。从外围设备中删除网络终结点，但没有执行此作的最后期限。
- ChangedIsExpressRoute - ExpressRoute 支持属性已更改。如果使用 ExpressRoute，可能需要采取措施，具体视配置而定。
- MovedIpOrUrl - 我们在此终结点集和另一终结点集之间移动了一个 IP 地址或 URL。通常无需采取任何措施。
- RemovedDuplicateIpOrUrl - 我们删除了重复的 IP 地址或 URL，但仍针对 Microsoft 365 发布。通常无需采取任何措施。
- OtherNonPriorityChanges - 我们更改了比所有其他选项不太重要的内容，例如备注字段的内容。
version - 在其中引入了更改的已发布终结点集的版本。版本号的格式 YYYYMMDDNN为，其中 NN ，如果需要在一天内发布多个版本，则为递增的自然数字。
previous - 一个子结构，详细说明终结点集上已更改元素的先前值。新添加的终结点集不包括此项。包括 ExpressRoute、serviceArea、category、required、tcpPortsudpPorts、和 notes。
current- 一个子结构，详细说明终结点集上更改元素的更新值。包括 ExpressRoute、serviceArea、category、required、tcpPortsudpPorts、和 notes。
add - 详细描述要添加到终结点集集合的项的子结构。如果没有要添加的项，将省略此元素。
- effectiveDate - 定义添加内容何时在服务中实时显示数据。
- ips - 要添加到数组的 ips 项。
- urls - 要添加到数组的 urls 项。
remove - 详细描述要从终结点集中删除的项的子结构。如果没有删除项，则省略。
- ips - 要从数组中删除的 ips 项。
- urls - 要从数组中删除的 urls 项。

更改 Web 方法示例

示例 1 请求 URI：https://endpoints.office.com/changes/worldwide/0000000000?ClientRequestId=b10c5ed1-bad1-445f-b386-b919946339a7

这会请求对 Microsoft 365 全球服务实例的所有先前更改。示例结果：

[
 {
  "id": 424,
  "endpointSetId": 32,
  "disposition": "Change",
  "version": "2018062700",
  "remove":
   {
    "urls":
     [
      "*.api.skype.com", "skypegraph.skype.com"
     ]
   }
 },
 {
  "id": 426,
  "endpointSetId": 31,
  "disposition": "Change",
  "version": "2018062700",
  "add":
   {
    "effectiveDate": "20180609",
    "ips":
     [
      "51.140.203.190/32"
     ]
   },
  "remove":
   {
    "ips":
     [

示例 2 请求 URI：https://endpoints.office.com/changes/worldwide/2018062700?ClientRequestId=b10c5ed1-bad1-445f-b386-b919946339a7

这请求自指定版本以来更改 Microsoft 365 Worldwide 实例。在这种情况下，指定的版本是最新的。示例结果：

[
  {
    "id":3,
    "endpointSetId":33,
    "changeDescription":"Removing old IP prefixes",
    "disposition":"Change",
    "version":"2018031301",
    "remove":{
      "ips":["65.55.127.0/24","66.119.157.192/26","66.119.158.0/25",
      "111.221.76.128/25","111.221.77.0/26","207.46.5.0/24"]
    }
  },
  {
    "id":4,
    "endpointSetId":45,
    "changeDescription":"Removing old IP prefixes",
    "disposition":"Change",
    "version":"2018031301",
    "remove":{
      "ips":["13.78.93.8/32","40.113.87.220/32","40.114.149.220/32",
      "40.117.100.83/32","40.118.214.164/32","104.208.31.113/32"]
    }
  }
]

PowerShell 脚本示例

你可以运行此 PowerShell 脚本来查看是否需要为更新的数据采取操作。你可以将此脚本作为计划任务运行，以检查是否存在版本更新。为了避免 Web 服务出现过多负载，每小时运行脚本的次数不要超过一次。

此脚本执行以下操作：

通过调用 Web 服务 REST API 检查当前 Microsoft 365 Worldwide 实例终结点的版本号。
在 $Env:TEMP\O365_endpoints_latestversion.txt中检查当前版本文件。全局变量 $Env：TEMP 的路径通常是 C:\Users\\<username\>\AppData\Local\Temp。
如果这是首次运行脚本，则脚本将返回当前版本以及所有当前 IP 地址和 URL，将终结点版本写入文件 $Env:TEMP\O365_endpoints_latestversion.txt ，并将终结点数据输出写入文件 $Env:TEMP\O365_endpoints_data.txt。可通过编辑以下行来修改输出文件的路径和/或名称：
```
$versionpath = $Env:TEMP + "\O365_endpoints_latestversion.txt"
$datapath = $Env:TEMP + "\O365_endpoints_data.txt"
```
每次后续执行脚本时，如果最新的 Web 服务版本与文件中的版本 O365_endpoints_latestversion.txt 相同，则脚本将退出而不进行任何更改。
当最新的 Web 服务版本高于文件中的版本 O365_endpoints_latestversion.txt 时，脚本将返回 “允许 ”和 “优化” 类别终结点的终结点和筛选器，更新文件中的版本 O365_endpoints_latestversion.txt ，并将更新后的数据写入 O365_endpoints_data.txt 文件。

脚本为执行该脚本的计算机生成唯 ClientRequestId 一的 ID，并在多个调用中重复使用此 ID。此 ID 存储在 O365_endpoints_latestversion.txt 文件中。

运行 PowerShell 脚本

复制脚本并将其保存到本地硬盘驱动器或脚本位置作为 Get-O365WebServiceUpdates.ps1。
在首选脚本编辑器（如 PowerShell ISE 或 VS Code）中执行脚本，或使用以下命令从 PowerShell 控制台执行：
```
powershell.exe -file <path>\Get-O365WebServiceUpdates.ps1
```
不向脚本传递任何参数。

<# Get-O365WebServiceUpdates.ps1
From https://aka.ms/ipurlws
v1.1 8/6/2019

DESCRIPTION
This script calls the REST API of the Microsoft 365 IP and URL Web Service (Worldwide instance)
and checks to see if there has been a new update since the version stored in an existing
$Env:TEMP\O365_endpoints_latestversion.txt file in your user directory's temp folder
(usually C:\Users\<username>\AppData\Local\Temp).
If the file doesn't exist, or the latest version is newer than the current version in the
file, the script returns IPs and/or URLs that have been changed, added or removed in the latest
update and writes the new version and data to the output file $Env:TEMP\O365_endpoints_data.txt.

USAGE
Run as a scheduled task every 60 minutes.

PARAMETERS
n/a

PREREQUISITES
PS script execution policy: Bypass
PowerShell 3.0 or later
Does not require elevation
#>

#Requires -Version 3.0

# web service root URL
$ws = "https://endpoints.office.com"
# path where output files will be stored
$versionpath = $Env:TEMP + "\O365_endpoints_latestversion.txt"
$datapath = $Env:TEMP + "\O365_endpoints_data.txt"

# fetch client ID and version if version file exists; otherwise create new file and client ID
if (Test-Path $versionpath) {
    $content = Get-Content $versionpath
    $clientRequestId = $content[0]
    $lastVersion = $content[1]
    Write-Output ("Version file exists! Current version: " + $lastVersion)
}
else {
    Write-Output ("First run! Creating version file at " + $versionpath + ".")
    $clientRequestId = [GUID]::NewGuid().Guid
    $lastVersion = "0000000000"
    @($clientRequestId, $lastVersion) | Out-File $versionpath
}

# call version method to check the latest version, and pull new data if version number is different
$version = Invoke-RestMethod -Uri ($ws + "/version/Worldwide?clientRequestId=" + $clientRequestId)
if ($version.latest -gt $lastVersion) {
    Write-Host "New version of Microsoft 365 worldwide commercial service instance endpoints detected"
    # write the new version number to the version file
    @($clientRequestId, $version.latest) | Out-File $versionpath
    # invoke endpoints method to get the new data
    $endpointSets = Invoke-RestMethod -Uri ($ws + "/endpoints/Worldwide?clientRequestId=" + $clientRequestId)
    # filter results for Allow and Optimize endpoints, and transform these into custom objects with port and category
    # URL results
    $flatUrls = $endpointSets | ForEach-Object {
        $endpointSet = $_
        $urls = $(if ($endpointSet.urls.Count -gt 0) { $endpointSet.urls } else { @() })
        $urlCustomObjects = @()
        if ($endpointSet.category -in ("Allow", "Optimize")) {
            $urlCustomObjects = $urls | ForEach-Object {
                [PSCustomObject]@{
                    category = $endpointSet.category;
                    url      = $_;
                    tcpPorts = $endpointSet.tcpPorts;
                    udpPorts = $endpointSet.udpPorts;
                }
            }
        }
        $urlCustomObjects
    }
    # IPv4 results
    $flatIp4s = $endpointSets | ForEach-Object {
        $endpointSet = $_
        $ips = $(if ($endpointSet.ips.Count -gt 0) { $endpointSet.ips } else { @() })
        # IPv4 strings contain dots
        $ip4s = $ips | Where-Object { $_ -like '*.*' }
        $ip4CustomObjects = @()
        if ($endpointSet.category -in ("Allow", "Optimize")) {
            $ip4CustomObjects = $ip4s | ForEach-Object {
                [PSCustomObject]@{
                    category = $endpointSet.category;
                    ip = $_;
                    tcpPorts = $endpointSet.tcpPorts;
                    udpPorts = $endpointSet.udpPorts;
                }
            }
        }
        $ip4CustomObjects
    }
    # IPv6 results
    $flatIp6s = $endpointSets | ForEach-Object {
        $endpointSet = $_
        $ips = $(if ($endpointSet.ips.Count -gt 0) { $endpointSet.ips } else { @() })
        # IPv6 strings contain colons
        $ip6s = $ips | Where-Object { $_ -like '*:*' }
        $ip6CustomObjects = @()
        if ($endpointSet.category -in ("Optimize")) {
            $ip6CustomObjects = $ip6s | ForEach-Object {
                [PSCustomObject]@{
                    category = $endpointSet.category;
                    ip = $_;
                    tcpPorts = $endpointSet.tcpPorts;
                    udpPorts = $endpointSet.udpPorts;
                }
            }
        }
        $ip6CustomObjects
    }

    # write output to screen
    Write-Output ("Client Request ID: " + $clientRequestId)
    Write-Output ("Last Version: " + $lastVersion)
    Write-Output ("New Version: " + $version.latest)
    Write-Output ""
    Write-Output "IPv4 Firewall IP Address Ranges"
    ($flatIp4s.ip | Sort-Object -Unique) -join "," | Out-String
    Write-Output "IPv6 Firewall IP Address Ranges"
    ($flatIp6s.ip | Sort-Object -Unique) -join "," | Out-String
    Write-Output "URLs for Proxy Server"
    ($flatUrls.url | Sort-Object -Unique) -join "," | Out-String
    Write-Output ("IP and URL data written to " + $datapath)

    # write output to data file
    Write-Output "Microsoft 365 IP and UL Web Service data" | Out-File $datapath
    Write-Output "Worldwide instance" | Out-File $datapath -Append
    Write-Output "" | Out-File $datapath -Append
    Write-Output ("Version: " + $version.latest) | Out-File $datapath -Append
    Write-Output "" | Out-File $datapath -Append
    Write-Output "IPv4 Firewall IP Address Ranges" | Out-File $datapath -Append
    ($flatIp4s.ip | Sort-Object -Unique) -join "," | Out-File $datapath -Append
    Write-Output "" | Out-File $datapath -Append
    Write-Output "IPv6 Firewall IP Address Ranges" | Out-File $datapath -Append
    ($flatIp6s.ip | Sort-Object -Unique) -join "," | Out-File $datapath -Append
    Write-Output "" | Out-File $datapath -Append
    Write-Output "URLs for Proxy Server" | Out-File $datapath -Append
    ($flatUrls.url | Sort-Object -Unique) -join "," | Out-File $datapath -Append
}
else {
    Write-Host "Microsoft 365 worldwide commercial service instance endpoints are up-to-date."
}

示例 Python 脚本

下面是在 Windows 10 上使用 Python 3.6.3 测试的 Python 脚本，你可以运行该脚本以查看是否需要对更新的数据执行作。此脚本检查 Microsoft 365 Worldwide 实例终结点的版本号。发生更改时，它会下载和类别终结点的 Allow 终结点和 Optimize 筛选器。它还在多个调用中使用唯一的 ClientRequestId，并保存临时文件中出现的最新版本。每小时调用一次此脚本，以检查是否存在版本更新。

import json
import tempfile
from pathlib import Path
import urllib.request
import uuid
# helper to call the webservice and parse the response
def webApiGet(methodName, instanceName, clientRequestId):
    ws = "https://endpoints.office.com"
    requestPath = ws + '/' + methodName + '/' + instanceName + '?clientRequestId=' + clientRequestId
    request = urllib.request.Request(requestPath)
    with urllib.request.urlopen(request) as response:
        return json.loads(response.read().decode())
# path where client ID and latest version number will be stored
datapath = Path(tempfile.gettempdir() + '/endpoints_clientid_latestversion.txt')
# fetch client ID and version if data exists; otherwise create new file
if datapath.exists():
    with open(datapath, 'r') as fin:
        clientRequestId = fin.readline().strip()
        latestVersion = fin.readline().strip()
else:
    clientRequestId = str(uuid.uuid4())
    latestVersion = '0000000000'
    with open(datapath, 'w') as fout:
        fout.write(clientRequestId + '\n' + latestVersion)
# call version method to check the latest version, and pull new data if version number is different
version = webApiGet('version', 'Worldwide', clientRequestId)
if version['latest'] > latestVersion:
    print('New version of Microsoft 365 worldwide commercial service instance endpoints detected')
    # write the new version number to the data file
    with open(datapath, 'w') as fout:
        fout.write(clientRequestId + '\n' + version['latest'])
    # invoke endpoints method to get the new data
    endpointSets = webApiGet('endpoints', 'Worldwide', clientRequestId)
    # filter results for Allow and Optimize endpoints, and transform these into tuples with port and category
    flatUrls = []
    for endpointSet in endpointSets:
        if endpointSet['category'] in ('Optimize', 'Allow'):
            category = endpointSet['category']
            urls = endpointSet['urls'] if 'urls' in endpointSet else []
            tcpPorts = endpointSet['tcpPorts'] if 'tcpPorts' in endpointSet else ''
            udpPorts = endpointSet['udpPorts'] if 'udpPorts' in endpointSet else ''
            flatUrls.extend([(category, url, tcpPorts, udpPorts) for url in urls])
    flatIps = []
    for endpointSet in endpointSets:
        if endpointSet['category'] in ('Optimize', 'Allow'):
            ips = endpointSet['ips'] if 'ips' in endpointSet else []
            category = endpointSet['category']
            # IPv4 strings have dots while IPv6 strings have colons
            ip4s = [ip for ip in ips if '.' in ip]
            tcpPorts = endpointSet['tcpPorts'] if 'tcpPorts' in endpointSet else ''
            udpPorts = endpointSet['udpPorts'] if 'udpPorts' in endpointSet else ''
            flatIps.extend([(category, ip, tcpPorts, udpPorts) for ip in ip4s])
    print('IPv4 Firewall IP Address Ranges')
    print(','.join(sorted(set([ip for (category, ip, tcpPorts, udpPorts) in flatIps]))))
    print('URLs for Proxy Server')
    print(','.join(sorted(set([url for (category, url, tcpPorts, udpPorts) in flatUrls]))))

    # TODO send mail (e.g. with smtplib/email modules) with new endpoints data
else:
    print('Microsoft 365 worldwide commercial service instance endpoints are up-to-date')

Web 服务接口版本控制

将来可能需要汇报这些 Web 服务方法的参数或结果。在这些 Web 服务的正式版本发布后，Microsoft 将做出合理的努力，以事先通知 Web 服务的实质性更新。如果认为更新必须变更使用 Web 服务的客户端，Microsoft 将在新版本发布后的至少 12 个月内保留旧版（上一版）Web 服务。在此期间未升级的客户可能无法访问 Web 服务及其方法。如果 Web 服务接口签名发生以下变更，客户必须确保 Web 服务的客户端能继续正常运行，而不出现错误：

将新的可选参数添加到现有 Web 方法中，此参数既不必由旧客户端提供，也不会影响旧客户端收到的结果。
将响应 REST 项之一或其他列中的新命名特性添加到响应 CSV。
添加具有旧客户端未调用的新名称的新 Web 方法。

更新通知

当 IP 地址和 URL 的变更发布到 Web 服务时，你可以使用几种不同的方法来获取电子邮件通知。

若要使用 Power Automate 解决方案，请参阅使用 Power Automate 接收电子邮件，了解Microsoft 365 个 IP 地址和 URL 的更改。
若要使用 PowerShell 编写自己的通知脚本，请参阅 Send-MailMessage。

导出代理 PAC 文件

Get-PacFile 是一个 PowerShell 脚本，用于从 Microsoft 365 IP 地址和 URL Web 服务读取最新的网络终结点，并创建示例 PAC 文件。有关使用 Get-PacFile 的信息，请参阅使用 PAC 文件直接路由重要Microsoft 365 流量。

反馈

此页面是否有帮助？

Last updated on 2026-03-11