通过

从断开连接的软件更新点同步 Microsoft 365 应用版更新

  • 项目

适用于: Configuration Manager(current branch)

从 Configuration Manager 版本 2002 开始，可以使用工具将 Microsoft 365 应用更新从连接 Internet 的 WSUS 服务器导入到断开连接的 Configuration Manager 环境中。 以前，在断开连接的环境中导出和导入软件更新的元数据时，无法部署Microsoft 365 应用版更新。 Microsoft 365 应用版更新需要从 Office API 和 Office CDN 下载其他元数据，这对于断开连接的环境是无法实现的。

注意

从 2020 年 4 月 21 日起，Office 365 专业增强版将重命名为 Microsoft 365 企业应用版。 有关详细信息，请参阅 Office 365 专业增强版的名称更改。 更新控制台时，仍可能会在 Configuration Manager 控制台和支持文档中看到对旧名称的引用。

先决条件

  • 运行 当前受支持的 Windows Server 版本的已连接 Internet 的 WSUS 服务器。

  • WSUS 服务器需要连接到以下 Internet 终结点：

    • officecdn.microsoft.com
    • config.office.com
    • clients.config.office.net
    • go.microsoft.com

  • 将 OfflineUpdateExporter 工具及其依赖项复制到连接到 Internet 的 WSUS 服务器。

    • 该工具及其依赖项位于 <ConfigMgrInstallDir>/tools/OfflineUpdateExporter 目录中。

  • 运行该工具的用户必须是 WSUS 管理员 组的一部分。

  • 为存储 Microsoft 365 Apps 更新元数据和内容的目录应具有适当的访问控制列表 (ACL) 来保护文件。

    • 此目录也必须为空。

  • 应安全地移动从联机 WSUS 服务器到断开连接环境的数据。

重要

将下载所有 Microsoft 365 种应用语言的内容。 每个更新可以包含大约 10 GB 的内容。

同步然后拒绝不需要Microsoft 365 应用更新

  1. 在连接到 Internet 的 WSUS 上，打开 WSUS 控制台。
  2. 依次选择“选项”、“产品和分类”。
  3. 在“产品”选项卡中，选择“Office 365 客户端”，然后在“分类”选项卡中选择“更新”。WSUS 中Microsoft 365 应用更新的产品和分类
  4. 转到 “同步” 并选择“ 立即同步” ，将Microsoft 365 应用更新获取到 WSUS。
  5. 同步完成后，拒绝不想使用 Configuration Manager 部署的任何Microsoft 365 应用版更新。 无需批准Microsoft 365 应用版更新即可下载。
    • 在 WSUS 中拒绝不需要的 Microsoft 365 应用更新不会阻止在 WsusUtil.exe 导出期间导出它们，但会阻止 OfflineUpdateExporter 工具下载它们的内容。
    • OfflineUpdateExporter 工具可为你下载 Microsoft 365 应用版更新。 如果要导出其他产品的更新，仍需要获得下载批准。
  6. 如果要批准其他产品更新进行下载和导出，请等待内容下载完成，然后运行 WsusUtil.exe 导出和复制 WSUSContent 文件夹的内容。 有关详细信息，请参阅 从断开连接的软件更新点同步软件更新

导出 Microsoft 365 应用版更新

  1. 将 OfflineUpdateExporter 文件夹从 Configuration Manager 复制到连接到 Internet 的 WSUS 服务器。

    • 该工具及其依赖项位于 <ConfigMgrInstallDir>/tools/OfflineUpdateExporter 目录中。

  2. 在连接到 Internet 的 WSUS 服务器上的命令提示符下，使用以下用法运行该工具： OfflineUpdateExporter.exe -O -D <目标路径>

    OfflineUpdateExporter 参数 说明
    -O -Office。 指定用于导出更新的产品是 Office 365 或 Microsoft 365 应用
    -D -Destination。 Destination 是必需参数，需要目标文件夹的整个路径。
    • OfflineUpdateExporter 工具执行以下操作：
      • 连接到 WSUS
      • 读取 WSUS 中的Microsoft 365 应用更新元数据
      • 将Microsoft 365 Apps 更新所需的内容和任何其他元数据下载到目标文件夹

  3. 在连接到 Internet 的 WSUS 服务器上的命令提示符下，导航到包含 WsusUtil.exe 的文件夹。 默认情况下，该工具位于 %ProgramFiles%\Update Services\Tools 中。 例如，如果工具位于默认位置，请键入 cd %ProgramFiles%\Update Services\Tools。

    • 运行 WsusUtil 工具的用户必须是服务器上的本地管理员组的成员。

  4. 键入以下命令，将软件更新元数据导出到 GZIP 文件：

    WsusUtil.exe 导出packagename日志文件

    例如：

    WsusUtil.exe 导出 export.xml.gz export.log

  5. 将 export.xml.gz 文件复制到断开连接网络上的顶级 WSUS 服务器。

  6. 如果已批准对其他产品的更新，请将 WSUSContent 文件夹的内容复制到已断开连接的 WSUS 服务器的顶级 WSUSContent 文件夹。

  7. 将用于 OfflineUpdateExporter 的目标文件夹复制到断开连接网络上的顶级 Configuration Manager 站点服务器。

导入 Microsoft 365 应用版更新

  1. 在断开连接的顶级 WSUS 服务器上，从在连接 Internet 的 WSUS 服务器上生成的 export.xml.gz 导入更新元数据。

    例如：

    WsusUtil.exe 导入 export.xml.gz import.log

    默认情况下，WsusUtil.exe 工具位于 %ProgramFiles%\Update Services\Tools 中。

  2. 导入完成后，需要在断开连接的顶级 Configuration Manager 站点服务器上配置站点控制属性。 此配置更改将 Configuration Manager 指向 Microsoft 365 应用的内容。 若要更改属性的配置，请执行以下操作：

    1. 将 O365OflBaseUrlConfigured PowerShell 脚本 复制到已断开连接的顶级 Configuration Manager 站点服务器。
    2. 更改为 "D:\Office365updates\content" 包含 offlineUpdateExporter 生成的 Microsoft 365 Apps 内容和元数据的复制目录的完整路径。

      重要

      只有本地路径适用于 O365OflBaseUrlConfigured 属性。

    3. 将脚本另存为 O365OflBaseUrlConfigured.ps1
    4. 在断开连接的顶级 Configuration Manager 站点服务器上提升的 PowerShell 窗口中，运行 .\O365OflBaseUrlConfigured.ps1。
    5. 在站点服务器上重启 SMS_Executive 服务。

  3. 在 Configuration Manager 控制台中，导航到 “管理>站点配置>站点”。

  4. 右键单击顶级站点，然后选择 “配置站点组件>软件更新点”。

  5. 在“ 分类 ”选项卡中，选择“ 更新”。 在“ 产品 ”选项卡中，选择“ Office 365 客户端”。

  6. 同步 Configuration Manager 的软件更新

  7. 同步完成后，使用正常过程部署Microsoft 365 应用版更新。

代理配置

  • 代理配置不是本机内置于该工具中。 如果在运行该工具的服务器上的“Internet 选项”中设置了代理，则从理论上讲，它将使用，并且应该正常工作。
    • 在命令提示符下，运行 netsh winhttp show proxy 以查看配置的代理。

修改 O365OflBaseUrlConfigured 属性

# Name: O365OflBaseUrlConfigured.ps1
#
# Description: This sample sets the O365OflBaseUrlConfigured property for the SMS_WSUS_CONFIGURATION_MANAGER component on the top-level site.
# This script must be run on the disconnected top-level Configuration Manager site server
#
# Replace "D:\Office365updates\content" with the full path to the copied directory containing all the Office metadata and content generated by the OfflineUpdateExporter tool.
# Only local paths work for the O365OflBaseUrlConfigured property.

$PropertyValue = "D:\Office365updates\content"

# Don't change any of the lines below
$PropertyName = "O365OflBaseUrlConfigured"

# Get provider instance
$providerMachine = Get-WmiObject -namespace "root\sms" -class "SMS_ProviderLocation"

if($providerMachine -is [system.array])
{
    $providerMachine=$providerMachine[0]
}

$SiteCode = $providerMachine.SiteCode

$component = gwmi -ComputerName $providerMachine.Machine -namespace root\sms\site_$SiteCode -query 'select comp.* from sms_sci_component comp join SMS_SCI_SiteDefinition sdef on sdef.SiteCode=comp.SiteCode where sdef.ParentSiteCode="" and comp.componentname="SMS_WSUS_CONFIGURATION_MANAGER"'
$properties = $component.props

Write-host "Updating $PropertyName property for site " $SiteCode

foreach ($property in $properties)
{
  if ($property.propertyname -eq $PropertyName)
  {
    Write-host "Current value for $PropertyName is $($property.value2)"
    $property.value2 = $PropertyValue
    Write-host "Updating value for $PropertyName to $($property.value2)"
    break
  }
}

$component.props = $properties
$component.put()

后续步骤

将软件更新添加到更新组