在 Configuration Manager 中針對 Microsoft 連線快取進行疑難排解Troubleshoot Microsoft Connected Cache in Configuration Manager

本文提供 Configuration Manager 中 Microsoft 連線快取的相關技術詳細資料。This article provides technical details about Microsoft Connected Cache in Configuration Manager. 可用來協助您針對環境中可能發生的問題進行疑難排解。Use it to help troubleshoot issues that you may have in your environment. 如需其運作方式及使用方式的詳細資訊,請參閱 Configuration Manager 中的 Microsoft 連線快取For more information on how it works and how to use it, see Microsoft Connected Cache in Configuration Manager.

注意

從 1910 版開始,這項功能現在稱為 Microsoft 連線快取Starting in version 1910, this feature is now called Microsoft Connected Cache. 先前稱為傳遞最佳化網路內快取 (DOINC)。It was previously known as Delivery Optimization In-Network Cache.

確認Verify

當您正確安裝「傳遞最佳化」快取伺服器,且正確設定用戶端時,它們會從發佈點上安裝的快取伺服器 (而不是網際網路) 下載。When you correctly install the Delivery Optimization cache server, and correctly configure clients, they download from the cache server installed on your distribution point rather than the internet.

在用戶端上在伺服器上確認此行為。Verify this behavior on a client or on the server.

在用戶端上驗證Verify on a client

  1. 在執行 Windows 10 1809 版或更新版本的用戶端上,下載雲端管理的內容。On client running Windows 10, version 1809 or later, download cloud-managed content. 如需連線快取所支援內容類型的詳細資訊,請參閱驗證連線快取For more information on the types of content that Connected Cache supports, see Verify Connected Cache.

  2. 開啟 PowerShell 並執行下列命令:Get-DeliveryOptimizationStatusOpen PowerShell and run the following command: Get-DeliveryOptimizationStatus

例如:For example:

PS C:\> Get-DeliveryOptimizationStatus

FileId                      : ec523d49c4f7c3c4444f0d9b952286ce40fdcee4
FileSize                    : 549064
TotalBytesDownloaded        : 549064
PercentPeerCaching          : 0
BytesFromPeers              : 0
BytesFromHttp               : 0
Status                      : Caching
Priority                    : Background
BytesFromCacheServer        : 549064
BytesFromLanPeers           : 0
BytesFromGroupPeers         : 0
BytesFromInternetPeers      : 0
BytesToLanPeers             : 0
BytesToGroupPeers           : 0
BytesToInternetPeers        : 0
DownloadDuration            : 00:00:00.0780000
HttpConnectionCount         : 2
LanConnectionCount          : 0
GroupConnectionCount        : 0
InternetConnectionCount     : 0
DownloadMode                : 99
SourceURL                   : http://au.download.windowsupdate.com/c/msdownload/update/software/defu/2019/09/am_delta_p
                              atch_1.301.664.0_ec523d49c4f7c3c4444f0d9b952286ce40fdcee4.exe
NumPeers                    : 0
PredefinedCallerApplication : WU Client Download
ExpireOn                    : 9/6/2019 8:36:19 AM
IsPinned                    : False

請注意,BytesFromCacheServer 屬性不是零。Notice that the BytesFromCacheServer attribute isn't zero.

如果未正確設定用戶端,或未正確安裝快取伺服器,則傳遞最佳化用戶端會回復為原始的雲端來源。If the client isn't configured correctly, or the cache server isn't installed correctly, the Delivery Optimization client falls back to the original cloud source. 然後,BytesFromCacheServer 屬性會是零。Then the BytesFromCacheServer attribute will be zero.

在伺服器上驗證Verify on the server

首先,驗證已正確設定登錄屬性:HKLM\SOFTWARE\Microsoft\Delivery Optimization In-Network CacheFirst, verify the registry properties are configured correctly: HKLM\SOFTWARE\Microsoft\Delivery Optimization In-Network Cache. 例如,磁碟機快取位置是 PrimaryDrivesInput\DOINC-E77D08D0-5FEA-4315-8C95-10D359D59294,其中 PrimaryDrivesInput 可以是多個磁碟機 (例如 C,D,E)。For example, the drive cache location is PrimaryDrivesInput\DOINC-E77D08D0-5FEA-4315-8C95-10D359D59294, where PrimaryDrivesInput can be multiple drives such as C,D,E.

接下來,使用下列方法,以必要標頭模擬伺服器的用戶端下載要求。Next, use the following method to simulate a client download request to the server with the mandatory headers.

  1. 以系統管理員的身分開啟 64 位元 PowerShell 視窗。Open a 64-bit PowerShell window as an administrator.
  2. 執行下列命令,並以伺服器的名稱或 IP 位址取代 <DoincServer>Run the following command, and replace the name or IP address of your server for <DoincServer>:
Invoke-WebRequest -URI "http://<DoincServer>/mscomtest/wuidt.gif" -Headers @{"Host"="b1.download.windowsupdate.com"}

輸出看起來類似下列範例:The output looks similar to the following example:

PS C:\WINDOWS\system32> Invoke-WebRequest -URI "http://SERVER01.CONTOSO.COM/mscomtest/wuidt.gif" -Headers @{"Host"="b1.download.windowsupdate.com"}


StatusCode        : 200
StatusDescription : OK
Content           : {71, 73, 70, 56...}
RawContent        : HTTP/1.1 200 OK
                    X-HW: 1567797125.dop019.se2.t,1567797125.cds058.se2.s,1567797125.dop114.at2.r,1567797125.cds079.at2
                    .p,1567797125.cds058.se2.p
                    X-CCC: cdP+dRBgUCoZO1mezA9zhg2VwQ7P1JWTh9k+GhfQmu8=_SLwv...
Headers           : {[X-HW, 1567797125.dop019.se2.t,1567797125.cds058.se2.s,1567797125.dop114.at2.r,1567797125.cds079.a
                    t2.p,1567797125.cds058.se2.p], [X-CCC,
                    cdP+dRBgUCoZO1mezA9zhg2VwQ7P1JWTh9k+GhfQmu8=_SLwvtSBQdT3uPQ5ikBe1ABMbdYIIncem+h5dtcLI6GY=],
                    [X-CID, 100], [Accept-Ranges, bytes]...}
RawContentLength  : 969710

下列屬性表示成功:The following attributes indicate success:

  • StatusCode : 200
  • StatusDescription : OK

記錄檔Log files

  • ARR 安裝記錄檔:%temp%\arr_setup.logARR setup log: %temp%\arr_setup.log

  • DO 快取伺服器安裝記錄檔:發佈點上的 SMS_DP$\Ms.Dsp.Do.Inc.Setup\DoincSetup.log,以及站台伺服器上的 DistMgr.logDO cache server setup log: SMS_DP$\Ms.Dsp.Do.Inc.Setup\DoincSetup.log on the distribution point, and DistMgr.log on the site server

  • IIS 作業記錄檔:預設為 %SystemDrive%\inetpub\logs\LogFilesIIS operational logs: By default, %SystemDrive%\inetpub\logs\LogFiles

  • DO 快取伺服器作業記錄檔:C:\Doinc\Product\Install\LogsDO cache server operational log: C:\Doinc\Product\Install\Logs

    提示

    在其他用途中,此記錄檔可協助您識別 Microsoft 雲端的連線問題。Among other uses, this log can help you identify connectivity issues with the Microsoft cloud.

安裝錯誤碼Setup error codes

下表列出 Configuration Manager 在發佈點上安裝連線快取元件時可能發生的可能錯誤碼:When Configuration Manager installs the Connected Cache component on the distribution point, the following table lists the possible error codes that might occur:

錯誤碼Error code 錯誤描述Error description
0x000000000x00000000 成功Success
0x00000BC20x00000BC2 成功,需要重新開機Success, reboot required
0x000006430x00000643 一般安裝失敗Generic install failure
0x00D000010x00D00001 只有在已安裝 Internet Information Services (IIS) 時,才能執行連線快取安裝程式Connected Cache setup can only be run if Internet Information Services (IIS) has been installed
0x00D000020x00D00002 只有在伺服器上有「預設的網站」時,才能執行連線快取安裝程式Connected Cache setup can only be run if a 'Default Web Site' exists on the server
0x00D000030x00D00003 如果已安裝應用程式要求路由 (ARR),則無法安裝連線快取You can't install Connected Cache if Application Request Routing (ARR) is already installed
0x00D000040x00D00004 只有在 Install.ps1 指令碼已安裝應用程式要求路由 (ARR) 時,才能執行連線快取安裝程式Connected Cache setup can only be run if Application Request Routing (ARR) was installed by the Install.ps1 script
0x00D000050x00D00005 連線快取安裝程式需要以系統管理員身分執行 PowerShell 工作階段Connected Cache setup requires a PowerShell session running as Administrator
0x00D000060x00D00006 連線快取安裝程式只能從 64 位元 PowerShell 環境執行Connected Cache setup can only be run from a 64-bit PowerShell environment
0x00D000070x00D00007 連線快取安裝程式只能在 Windows Server 上執行Connected Cache setup can only be run on a Windows Server
0x00D000080x00D00008 失敗:所指定快取磁碟機數目必須符合指定的快取磁碟機大小百分比數目Failure: The number of cache drives specified must match the number of cache drive size percentages specified
0x00D000090x00D00009 失敗:必須提供有效的快取節點識別碼Failure: A valid cache node ID must be supplied
0x00D0000A0x00D0000A 失敗:必須提供有效的快取磁碟機集合Failure: A valid cache drive set must be supplied
0x00D0000B0x00D0000B 失敗:必須提供有效的快取磁碟機大小百分比集合Failure: A valid cache drive size percent set must be supplied
0x00D0000C0x00D0000C 失敗:必須提供有效的快取磁碟機大小百分比集合或快取磁碟機大小 (GB)Failure: A valid cache drive size percent set or cache drive size in GB must be supplied
0x00D0000D0x00D0000D 失敗:無法同時提供有效的快取磁碟機大小百分比集合與快取磁碟機大小 (GB)Failure: A valid cache drive size percent set and cache drive size in GB cannot both be supplied
0x00D0000E0x00D0000E 失敗:所指定快取磁碟機數目必須符合指定的快取磁碟機大小 (GB) 數目Failure: The number of cache drives specified must match the number of cache drive size in GB specified
0x00D0000F0x00D0000F 失敗:無法將 applicationhost.config 檔案從 $AppHostConfig 備份至 $AppHostConfigDestinationNameFailure: Couldn't back up the applicationhost.config file from $AppHostConfig to $AppHostConfigDestinationName
0x00D000100x00D00010 失敗:無法將預設的網站 web.config 檔案從 $WebsiteConfigFilePath 備份至 $WebConfigDestinationNameFailure: Couldn't back up the Default Web Site web.config file from $WebsiteConfigFilePath to $WebConfigDestinationName
0x00D000110x00D00011 失敗:SetupARRWebFarm.ps1 中發生例外狀況Failure: An exception occurred in SetupARRWebFarm.ps1
0x00D000120x00D00012 失敗:SetupARRWebFarmRewriteRules.ps1 中發生例外狀況Failure: An exception occurred in SetupARRWebFarmRewriteRules.ps1
0x00D000130x00D00013 失敗:SetupARRWebFarmProperties.ps1 中發生例外狀況Failure: An exception occurred in SetupARRWebFarmProperties.ps1
0x00D000140x00D00014 失敗:SetupAllowableServerVariables.ps1 中發生例外狀況Failure: An exception occurred in SetupAllowableServerVariables.ps1
0x00D000150x00D00015 失敗:SetupFirewallRules.ps1 中發生例外狀況Failure: An exception occurred in SetupFirewallRules.ps1
0x00D000160x00D00016 失敗:SetupAppPoolProperties.ps1 中發生例外狀況Failure: An exception occurred in SetupAppPoolProperties.ps1
0x00D000170x00D00017 失敗:SetupARROutboundRules.ps1 中發生例外狀況Failure: An exception occurred in SetupARROutboundRules.ps1
0x00D000180x00D00018 失敗:SetupARRDiskCache.ps1 中發生例外狀況Failure: An exception occurred in SetupARRDiskCache.ps1
0x00D000190x00D00019 失敗:SetupARRProperties.ps1 中發生例外狀況Failure: An exception occurred in SetupARRProperties.ps1
0x00D0001A0x00D0001A 失敗:SetupARRHealthProbes.ps1 中發生例外狀況Failure: An exception occurred in SetupARRHealthProbes.ps1
0x00D0001B0x00D0001B 失敗:VerifyIISSItesStarted.ps1 中發生例外狀況Failure: An exception occurred in VerifyIISSItesStarted.ps1
0x00D0001C0x00D0001C 失敗:SetDrivesToHealthy.ps1 中發生例外狀況Failure: An exception occurred in SetDrivesToHealthy.ps1
0x00D0001D0x00D0001D 失敗:VerifyCacheNodeSetup.ps1 中發生例外狀況Failure: An exception occurred in VerifyCacheNodeSetup.ps1
0x00D0001E0x00D0001E 如果預設網站不在連接埠 80 上,您就無法安裝連線快取You can't install Connected Cache if the Default Web Site isn't on port 80
0x00D0001F0x00D0001F 失敗:快取磁碟機配置 (百分比) 不能超過 100Failure: The cache drive allocation in percentage can't exceed 100
0x00D000200x00D00020 失敗:快取磁碟機配置 (GB) 不能超過磁碟機的可用空間Failure: The cache drive allocation in GB cannot exceed the drive's free space
0x00D000210x00D00021 失敗:快取磁碟機配置 (百分比) 必須大於 0Failure: The cache drive allocation in percentage must be greater than 0
0x00D000220x00D00022 失敗:快取磁碟機配置 (GB) 必須大於 0Failure: The cache drive allocation in GB must be greater than 0
0x00D000230x00D00023 失敗:RegisterScheduledTask_CacheNodeKeepAlive 中發生例外狀況Failure: An exception occurred in RegisterScheduledTask_CacheNodeKeepAlive
0x00D000240x00D00024 失敗:RegisterScheduledTask_Maintenance 中發生例外狀況Failure: An exception occurred in RegisterScheduledTask_Maintenance
0x00D000250x00D00025 失敗:設定下列 HTTPS 伺服器陣列的重寫規則時發生例外狀況:$FarmNameFailure: An exception occurred setting up the rewrite rules for HTTPS farm: $FarmName
0x00D000260x00D00026 失敗:設定下列 HTTP 伺服器陣列的重寫規則時發生例外狀況:$FarmNameFailure: An exception occurred setting up the rewrite rules for HTTP farm: $FarmName
0x00D000270x00D00027 您無法安裝連線快取,因為無法安裝相依軟體「應用程式要求路由 (ARR)」。You can't install Connected Cache because dependent software "Application Request Routing (ARR)" failed to install. 請參閱位於 %temp%\arr_setup.log 的記錄檔See the log file located at %temp%\arr_setup.log

IIS 設定IIS configurations

DO 快取伺服器安裝會對發佈點上的 IIS 設定進行幾項修改。The DO cache server install makes several modifications to the IIS configuration on the distribution point.

應用程式要求路由Application request routing

DO 快取伺服器會安裝及設定 IIS 應用程式要求路由 (ARR)The DO cache server installs and configures IIS Application Request Routing (ARR). 為避免可能發生的衝突,發佈點無法安裝此元件。To avoid potential conflicts, the distribution point can't already have this component installed.

允許的伺服器變數Allowed server variables

在您安裝 DO 快取伺服器之後,預設的網站會有下列「本機」伺服器變數:After you install the DO cache server, the default web site has the following local server variables:

  • HTTP_HOSTHTTP_HOST
  • QUERY_STRINGQUERY_STRING
  • X-CCCX-CCC
  • X-CIDX-CID
  • X-DOINC-OUTBOUNDX-DOINC-OUTBOUND

重寫規則Rewrite rules

DO 快取伺服器會新增下列重寫規則:The DO cache server adds the following rewrite rules:

輸入重寫規則Inbound rewrite rules

  • Doinc_ForwardToFarm_shswda01.download.manage-selfhost.microsoft.com_E77D08D0-5FEA-4315-8C95-10D359D59294
  • Doinc_ForwardToFarm_swdc01.manage.microsoft.com_E77D08D0-5FEA-4315-8C95-10D359D59294
  • Doinc_ForwardToFarm_swdc02.manage.microsoft.com_E77D08D0-5FEA-4315-8C95-10D359D59294
  • Doinc_ForwardToFarm_dl.delivery.mp.microsoft.com_E77D08D0-5FEA-4315-8C95-10D359D59294
  • Doinc_ForwardToFarm_officecdn.microsoft.com_E77D08D0-5FEA-4315-8C95-10D359D59294
  • Doinc_ForwardToFarm_b1.download.windowsupdate.com_E77D08D0-5FEA-4315-8C95-10D359D59294
  • Doinc_ForwardToFarm_download.windowsupdate.com_E77D08D0-5FEA-4315-8C95-10D359D59294
  • Doinc_ForwardToFarm_officecdn.microsoft.com.edgesuite.net_E77D08D0-5FEA-4315-8C95-10D359D59294
  • Doinc_ForwardToFarm_au.b1.download.windowsupdate.com_E77D08D0-5FEA-4315-8C95-10D359D59294
  • Doinc_ForwardToFarm_assets1.xboxlive.com_E77D08D0-5FEA-4315-8C95-10D359D59294
  • Doinc_ForwardToFarm_au.download.windowsupdate.com_E77D08D0-5FEA-4315-8C95-10D359D59294
  • Doinc_ForwardToFarm_emdl.ws.microsoft.com_E77D08D0-5FEA-4315-8C95-10D359D59294
  • Doinc_ForwardToFarm_tlu.dl.delivery.mp.microsoft.com_E77D08D0-5FEA-4315-8C95-10D359D59294
  • Doinc_ForwardToFarm_assets2.xboxlive.com_E77D08D0-5FEA-4315-8C95-10D359D59294

輸出重寫規則Outbound rewrite rules

  • Doinc_Outbound_SetHeader_X_CID_E77D08D0-5FEA-4315-8C95-10D359D59294
  • Doinc_Outbound_SetHeader_X_CCC_E77D08D0-5FEA-4315-8C95-10D359D59294

管理伺服器資源Manage server resources

每部 DO 快取伺服器所需磁碟空間可能會根據您組織的更新需求而有所不同。Disk space required for each DO cache server may vary, based on your organization's update requirements. 100 GB 應該有足夠的空間來快取下列內容:100 GB should be enough space to cache the following content:

  • 功能更新A feature update
  • 兩到三個月的品質和 Microsoft 365 Apps 更新Two to three months of quality and Microsoft 365 Apps updates
  • Microsoft Intune 應用程式和 Windows 收件匣應用程式Microsoft Intune apps and Windows inbox apps

DO 快取伺服器不應耗用太多的系統記憶體或處理器時間。The DO cache server shouldn't consume much system memory or processor time. 當您安裝 DO 快取伺服器之後,如果您發現大量的處理序或記憶體資源耗用量,請分析 IIS 和 ARR 記錄檔。After you install the DO cache server, if you notice significant process or memory resource consumption, analyze the IIS and ARR log files.

如果 IIS 和 ARR 記錄檔在伺服器上佔用太多空間,您可以使用數種方法來管理記錄檔。If the IIS and ARR log files take up too much space on the server, there are several methods you can use to manage the log files. 如需詳細資訊,請參閱 Managing IIS Log File Storage (管理 IIS 記錄檔儲存體)。For more information, see Managing IIS Log File Storage.

請參閱See also

Configuration Manager 中的 Microsoft 連線快取Microsoft Connected Cache in Configuration Manager