內容庫清理工具

  • 發行項

適用於：Configuration Manager (目前的分支)

使用內容庫清除命令列工具來移除不再與發佈點上的物件相關聯的內容。 這種類型的內容稱為 孤立內容。 此工具會取代針對過去Configuration Manager產品發行的舊版類似工具。

此工具只會影響您在執行工具時指定之發佈點上的內容。 此工具無法從月臺伺服器上的內容庫移除內容。

如果您在月臺系統離線時從發佈點移除內容，WMI 中可能會有孤立的記錄。 經過一段時間後，此行為最終可能會導致發佈點出現警告狀態。 若要減輕 2006 版和更早版本中的問題，您必須手動從 WMI 移除孤立的專案。 在此程式期間發生錯誤，可能會導致伺服器發生更嚴重的問題。 從 2010 版開始，此工具也可以從發佈點上的 WMI 提供者移除孤立的內容記錄。

在月臺伺服器上尋找 ContentLibraryCleanup.exeCD.Latest\SMSSETUP\TOOLS\ContentLibraryCleanup 。 如需此位置的詳細資訊， 請參閱 CD.Latest 資料夾。

需求

  • 一次只對單一發布點執行工具。

  • 直接在裝載發佈點的伺服器上執行以進行清除，或從另一部電腦遠端執行。

  • 此工具不支援從具有單一內容庫的月臺伺服器移除內容。 當月臺伺服器也有發佈點角色時，如果套件不是以伺服器為目標，則封裝仍位於單一內容庫中。

  • 此工具不支援已啟用內容的雲端管理閘道。

  • 執行工具的使用者帳戶必須具有與 Configuration Manager 中系統高許可權系統管理員安全性角色相同的許可權。

作業模式

以下列兩種模式執行工具： 假設 和 刪除。

提示

從 假設 模式開始。 當您滿意結果時，請以 刪除 模式執行工具。

假設模式

如果您未指定 /delete 參數，此工具會以假設模式執行。 此模式會識別要從發佈點刪除的內容。

  • 在此模式中執行時，此工具不會刪除任何資料。

  • 此工具會寫入其要刪除之內容的記錄檔資訊。 系統不會提示您確認每個可能的刪除。

刪除模式

當您使用 /delete 參數執行工具時，工具會以刪除模式執行。

  • 在此模式中執行時，可以在指定的發佈點上找到的孤立內容，從發佈點的內容庫中刪除。

  • 從 2010 版開始，它也可以從發佈點上的 WMI 提供者移除孤立的內容記錄。

  • 刪除每個檔案之前，請先確認工具應該將它刪除。 選取 [Y ] 作為 [是]、 [N ] 表示 [否]，或 [ 全部是] 以 略過進一步提示並刪除所有孤立的內容。

記錄檔

當工具在任一模式中執行時，它會自動建立記錄檔。 它會使用下列資訊為檔案命名：

  • 工具在其中執行的模式
  • 發佈點的名稱
  • 作業的日期和時間

當工具完成時，它會自動在 Windows 中開啟記錄檔。

根據預設，此工具會將記錄檔寫入執行工具之使用者帳戶的暫存資料夾。 此位置位於您執行工具的電腦上，這不一定是工具的目標。 /log使用 參數將記錄檔重新導向至另一個位置，包括網路共用。

執行工具

若要執行工具：

  1. 以系統管理員身分開啟命令提示字元。 將目錄變更為包含 ContentLibraryCleanup.exe的資料夾。

  2. 輸入命令列，其中包含必要的 命令列參數，以及您想要使用的任何選擇性參數。

命令列參數

請依任何順序使用這些命令列參數。

必要參數

參數 詳細資料
/dp <distribution point FQDN> 指定要清除之發佈點 (FQDN) 的完整功能變數名稱。
/ps <primary site FQDN> 只有在從次要月臺的發佈點清除內容時才需要。 此工具會連線到父主要月臺，以對 SMS 提供者執行查詢。 這些查詢可讓工具判斷發佈點上應該有哪些內容。 然後，它可以識別要移除的孤立內容。 必須針對次要月臺上的發佈點建立與父主要月臺的連線，因為不需要直接從次要月臺取得所需的詳細資料。
/sc <primary site code> 只有在從次要月臺的發佈點清除內容時才需要。 指定父主要月臺的月臺碼。

範例：掃描並記錄它會刪除的內容 (假設)

ContentLibraryCleanup.exe /dp server1.contoso.com

範例：在次要月臺掃描和記錄 DP 的內容

ContentLibraryCleanup.exe /dp server1.contoso.com /ps siteserver1.contoso.com /sc ABC

選擇性參數

參數 詳細資料
/delete 當您準備好從發佈點刪除內容時，請使用此參數。 它會在刪除內容之前提示您。

當您未使用此參數時，此工具會記錄其會刪除哪些內容的結果。 如果沒有這個參數，它就不會實際從發佈點刪除任何內容。
/q 此參數會以隱藏所有提示的無訊息模式執行工具。 這些提示包括刪除內容時。 也不會自動開啟記錄檔。
/ps <primary site FQDN> 只有在從主要月臺的發佈點清除內容時才選擇性。 指定發佈點所屬主要月臺的 FQDN。
/sc <primary site code> 只有在從主要月臺的發佈點清除內容時才選擇性。 指定發佈點所屬主要月臺的月臺碼。
/log <log file directory> 指定工具寫入記錄檔的位置。 此位置可以是本機磁片磁碟機或網路共用。

當您未使用此參數時，此工具會將記錄檔放在執行工具的電腦上的使用者臨時目錄中。

範例：刪除內容

ContentLibraryCleanup.exe /dp server1.contoso.com /delete

範例：刪除內容而不提示

ContentLibraryCleanup.exe /q /dp server1.contoso.com /delete

範例：登入本機磁片磁碟機

ContentLibraryCleanup.exe /dp server1.contoso.com /log C:\Users\Administrator\Desktop

範例：登入網路共用

ContentLibraryCleanup.exe /dp server1.contoso.com /log \\server\share

已知問題

在 2103 版和更早版本中，當任何套件或部署失敗或正在進行中時，此工具可能會傳回下列錯誤：

System.InvalidOperationException: This content library cannot be cleaned up right now because package <packageID> is not fully installed.

若要解決此問題，請將月臺更新為 2107 版。 此工具無法可靠地識別孤立的檔案，但會顯示警告並繼續。