使用Microsoft 365 應用程式整備工具組評估應用程式相容性

整備報告建立工具可以掃描Word、Excel、PowerPoint、Outlook、Access、Project、Visio 及Publisher 檔案中的VBA 巨集，即使是Office 2003 這麼舊 ... 跳到主要內容 已不再支援此瀏覽器。

請升級至MicrosoftEdge，以利用最新功能、安全性更新和技術支援。

下載MicrosoftEdge 其他資訊 目錄 結束焦點模式 閱讀英文 儲存 目錄 閱讀英文 儲存 編輯 Twitter LinkedIn Facebook 電子郵件 目錄 使用Microsoft365應用程式整備工具組評估應用程式相容性 發行項 05/07/2022 2位參與者 本文內容 ReadinessToolkitforOfficeadd-insandVBA可以協助您識別您的MicrosoftVisualBasicforApplications(VBA)巨集和您與Office搭配使用的增益集的相容性問題。

整備工具組包括整備報告建立工具，它會建立具有VBA巨集相容性和增益集整備資訊的Excel報告，協助您的組織評估移至Microsoft365Apps的整備程度。

您可以從Microsoft下載中心免費下載整備工具組。

我們建議您一律下載及使用最新版本。

當您執行報告時，整備工具組會檢查是否您正在使用的最新版本，並會提示您下載最新的版本。

在安裝最新版本前，您不必解除安裝舊版的整備工具組。

重要 整備工具組無法修復或修正您的VBA巨集中的程式碼。

如果您建立進階報告，報告會在可行時提供修復VBA巨集程式碼的指引。

整備報告建立工具可以掃描Word、Excel、PowerPoint、Outlook、Access、Project、Visio及Publisher檔案中的VBA巨集，即使是Office2003這麼舊的Office版本。

它也可以掃描與Office搭配使用的特定類型增益集。

可以識別所有Office應用程式的增益集，但是不包括Web增益集。

如需詳細資訊，請參閱針對VBA巨集分析的副檔名和整備報告建立工具會收集其資料的增益集類型。

下載項目是MSI檔案，您可以用來在使用者的電腦上安裝整備工具組。

安裝之後，當您執行整備報告建立工具時，UI精靈會逐步引導您進行建立整備報告的程序。

另外也有可以從命令列執行或透過指令碼來使用的獨立可執行檔。

如果您需要以更加自動化的方式收集整個企業中使用者的整備資訊，則獨立可執行檔很有用。

如需詳細資訊，請參閱取得企業中多位使用者的整備資訊。

下列資訊可協助您使用整備報告建立工具： 建立整備報告，包括需求和限制，選擇作為基礎來建立報告的資訊，以及基本與進階報告之間的差異。

整備報告中的資訊，適用於VBA巨集和增益集整備。

取得企業中多位使用者的整備資訊，並且使用命令列版本的整備報告建立工具來掃描多部電腦。

使用SQLServer儲存報告結果並使用PowerBI分析報告結果，以克服使用Excel的一些限制，尤其是對於包含大量資料的報告。

使用標籤來分類及篩選報告中的資料可協助您分析您的組織的整備程度並且進行決策。

管理報表中所收集資料的隱私權可讓您知道如何隱藏檔案路徑和名稱的機密資訊。

收集並顯示在報告中的增益集使用資訊可以更了解您的組織中最常使用哪些增益集以及是誰使用這些了增益集。

其他資訊，包括整備報告建立工具分析的副檔名、整備報告建立工具會收集其資料的增益集類型，以及當建立進階報告時傳送給Microsoft的資訊範例。

注意 許多企業在執行ReadinessToolkit後，發現相容性問題比之前的預計要少。

以企業版所提供的資料為基礎來執行ReadinessToolkit，平均6%的掃描檔案有巨集，而這些檔案中的3.3%有巨集問題。

所以這代表僅有0.2%的檔案有巨集相容性問題。

在Office增益集中，已找到的75%被分類為採用或支援。

如果您有關於整備工具組的意見反應或問題，請傳送電子郵件到[email protected]與我們連絡。

建立整備報告 使用整備工具組的需求和限制 在安裝及使用整備工具組之前，您應該注意下列需求： Windows7ServicePack1(SP1)或更新版本 Microsoft.NETFramework4.5.1或更新版本 Excel2010或更新版本 MicrosoftAccessDatabaseEngine2010可轉散發套件(只有在您是使用隨選即用版本的Access時才適用) 注意 我們建議使用64位元版本的Excel，特別是當您預期在整備報告中有超過400,000筆結果時。

Windows7和Excel2010已不再支援產品。

此外，您還應該了解整備報告建立工具的一些限制： 整備報告建立工具無法掃描受密碼保護的檔案，如果您嘗試掃描此類檔案，檔案會在報告中顯示為「受密碼保護」。

預設情況下，整備報告建立者無法掃描儲存在SharePoint文件庫、OneDrive或一些其他類型的雲端儲存位置的檔案。

如果您嘗試掃描此類檔案，檔案會在報告中顯示為「雲端式」。

如需可能的因應措施，請參閱如何掃描雲端式的檔案。

整備報告建立工具會在Excel工作表的個別資料列中列出Office文件的每個問題。

因此，整備報告建立工具只能傳回1,046,575筆結果。

如果您預期會超過這個限制，我們建議您將報告的範圍縮小，例如縮小為特定部門。

選擇要用來建立報告的資訊 若要建立整備報告，首先您需要選擇用來建立報告的資訊。

下表列出可能的選項和每個選項的說明。

它也會指定各個選項會建立哪種類型的整備報告。

選項 說明 建立的報告 這部電腦上最近使用的Office文件和已安裝增益集 整備報告建立工具只會掃描使用者最近使用檔案清單中的Office文件。

這樣可以讓您將掃描焦點縮小到使用者定期存取的文件上。

此外，整備報告建立工具會尋找在整備報告建立工具執行所在的電腦上安裝的任何Office增益集。

VBA和增益集 本機資料夾或網路共用中的Office文件。

整備報告建立工具會掃描您指定的資料夾或網路共用中的Office文件。

整備報告建立工具會自動掃描指定位置及該位置中的所有子資料夾。

附註：使用此選項，整備報告建立工具就不會尋找安裝在整備報告建立工具執行所在電腦上的增益集。

僅限VBA 先前的整備結果會一起儲存在本機資料夾或網路共用。

此選項可讓您建立由多部獨立電腦的個別整備結果所組成的彙總報告。

例如，您可能會在「財務」部門的所有電腦上執行整備報告建立工具，將每個掃描的結果儲存至網路共用。

然後，您可以使用此選項來建立「財務」部門的彙總報告。

如需詳細資訊，請參閱取得企業中多位使用者的整備資訊。

僅限VBA或VBA和增益集，取決於使用哪個整備結果。

來自Office遙測儀表板的增益集資料。

如果您使用Office遙測儀表板評估增益集相容性，您可以使用您收集的資訊來建立整備報告。

您只需要將用來存取Office遙測儀表板資料庫的適當資訊提供給整備報告建立工具。

附註：使用此選項，整備報告建立工具就不會尋找VBA巨集。

要執行此選項的使用者需要有資料庫上的GRANTSELECT存取權。

僅限增益集 在基本與進階報告之間選擇 在您選取要用什麼資訊來建立報告並且指定儲存報告的位置之後，您必須選擇要建立基本報告或進階報告。

我們強烈建議您建立進階報告，因為進階報告提供額外的資訊，可以協助您評估您的VBA巨集和增益集與Microsoft365Apps的相容性。

例如，您會在進階報告中取得下列額外資訊： 針對在您的VBA巨集中找到的問題的補救建議(如果有的話)。

此資訊會顯示在報告的個別工作表中。

增益集的整備狀態。

例如，報告可能會顯示軟體提供者有Microsoft365應用程式增益集的支援版本。

增益集的整備狀態是從以遙測為基礎的計算衍生而來，並且明確支援來自ISV的陳述式。

為了向您提供最新的修復建議和整備狀態，整備報告建立工具會在建立報告時與Microsoft連絡。

您的VBA巨集和增益集的某些相關資訊會傳送給Microsoft。

如需會傳送哪些項目的詳細資訊，請參閱建立進階報告時傳送給Microsoft的資訊範例。

重要：如果您要建立進階報告，請確認您執行整備工具組所在的電腦具有網際網路存取權。

整備工具組會呼叫可公開取得的Web服務，因此您的防火牆必須允許下列URL： https://officeclient.microsoft.com/serverconfig16 https://ready.osi.office.net/orfo/api/readinesssummary https://ready.osi.office.net/orfo/api/vbareportsummary 解譯整備報告中的資訊 整備報告建立工具會以Excel檔案格式建立整備報告。

報告中可用的整備資訊取決於您的報告是以哪些資訊為基礎，以及您選擇要建立基本或進階報告。

每份報告都是以[概觀]頁面開始，該頁面提供結果的高階資訊，以及可用報告的連結-VBA或增益集或者兩者。

VBA整備報告 下表提供VBA整備報告中顯示的不同索引標籤(工作表)的清單。

工作表名稱 內容 VBA概觀 顯示三個圓形圖以提供掃描結果的高階概觀。

每個圓形圖顯示不同的資訊：已掃描檔案的狀態、掃描期間找到的唯一巨集的整備狀態，以及已掃描唯一檔案的整備狀態。

請參閱本節稍後的表格，以取得有關檔案狀態與這些圓形圖中顯示的整備狀態值的詳細資訊。

整備工具組會建立VBA巨集程式碼的唯一雜湊，以找出在多個檔案中重複使用的巨集。

整備工具組會執行類似的操作以找出重複的檔案。

整備工具組會執行這個操作，以便為您提供必須評估多少唯一VBA巨集和唯一檔案的更實際評估。

附註：如果您打算部署64位元版本的Microsoft365應用程式，請確定已勾選[包含64位元整備資料]核取方塊，並且已重新整理報告。

VBA摘要 提供一些預先定義的樞紐分析表，讓您分析從掃描擷取的資料。

如果這些樞紐分析表不符合您的特定需求，您可以根據VBA結果工作表上的資料自行建立。

VBA結果 提供整備報告建立工具掃描的每個檔案的資訊。

如果在掃描的檔案中找到多個問題，每個問題都有個別資料列。

請參閱本節結尾「詳細VBA資訊」標題底下的表格，以取得每個欄位中顯示資訊的說明。

VBA修復 提供掃描期間找到的VBA巨集程式碼的建議變更。

請參閱本節結尾「詳細VBA資訊」標題底下的表格，以取得每個欄位中顯示資訊的說明。

VBA參考 列出在程式碼和VBA專案中識別的參考。

這些參考通常會用於呼叫外部DLL、連結檔案及VBA程式碼所使用的ODBC連線。

請參閱本節結尾「詳細VBA資訊」標題底下的表格，以取得每個欄位中顯示資訊的說明。

檔案狀態：報告也會依據檔案狀態對掃描的檔案進行分類。

下表列出整備報告中顯示的可能檔案狀態，以及檔案狀態的說明。

檔案狀態 說明 沒有VBA 已掃描檔案，找不到任何VBA巨集程式碼。

具有VBA 已掃描檔案，找到VBA巨集程式碼。

雲端式 無法掃描檔案，因為它儲存在SharePoint文件庫、OneDrive或某些其他類型的雲端式儲存位置。

受密碼保護 檔案受密碼保護，所以它不會針對VBA巨集進行掃描。

無法存取 因為某些原因而無法掃描檔案，例如整備報告建立工具沒有足夠權限可以存取檔案、檔案已損毀，或者檔案使用很舊的Office檔案格式。

無法存取-需要驅動程式 無法掃描檔案，因為在執行掃描的電腦上未安裝必要的MicrosoftAccessDatabaseEngine2010。

鎖定 執行掃描時檔案已鎖定或在使用中。

錯誤 掃描期間嘗試讀取的VBA程式碼串流不是有效格式。

有時候開啟然後儲存支援Office版本的檔案，可讓整備報告建立工具掃描檔案。

嚴重性等級：報告會依據嚴重性等級對VBA巨集中找到的問題進行分類，協助您估計解決所找到的問題需要多少努力。

如果找到多個VBA巨集的問題，報告會在圓形圖中顯示最高的嚴重性等級。

下表列出整備報告中顯示的可能嚴重性，以及嚴重性等級的說明。

嚴重性 說明 準備升級 在此檔案中找不到問題，且該檔案與Microsoft365應用程式相容。

程式碼設計認知 程式碼將會如預期般運作，而且使用者不太會發現任何變更、功能、屬性或方法的運作方式與先前版本不同，或者可能在較新版本中已遭到取代。

建議的基本驗證 預期不會有執行階段或編譯時間錯誤，但是API功能可能已經以某種方式變更。

建議使用者對Microsoft365Apps的檔案執行快速檢查，以確定檔案持續如預期般運作。

若要將環境問題降至最低，理想情況是在經常執行巨集的電腦上執行快速檢查。

需要有限修復 需要某些程序碼重構。

但是會有一個清楚的取代動作，因此預期修正巨集所需的工作會大量減少。

需要大量修復 需要大量程式碼重構，讓程式碼繼續如舊版Office版本一樣運作。

例如，API已遭到取代，但是未提供取代的功能。

在此情況下，唯一的可用選項是重新建立功能。

詳細VBA資訊：VBA整備報告中的[VBA結果]、[VBA修復]和[VBA參考]索引標籤都包含類似的資訊資料行。

下表提供這些資料行的清單，以及這些資料行所包含資訊的說明。

資料行名稱 說明 範例 指導方針 掃描文件時識別的指導方針(規則)。

Access2013中不再有程式工具列和功能表列。

嚴重性 所識別問題的嚴重性。

需要大量修復 來源位置 已掃描檔案的位置。

D:\我的文件\我的檔案\ 來源檔案 已掃描檔案的名稱。

MyFileName.xlsx 來源檔案雜湊 檔案的唯一產生雜湊。

36426A0DCFC06F6425E205F107A5CA58 來源檔案副檔名 已掃描檔案的副檔名。

.docm 模組 在其中識別程式碼問題的模組名稱。

mDJSCommandBars 行號 在其中識別程式碼問題的行號。

112 類型 已識別的問題類型。

VBA 成員 在其中識別問題的VBA模組區段名稱(亦即函數)。

CommandBars 陳述式 在其中識別問題的程式碼區段。

DimctlNameAsCommandBarControl VBA雜湊 VBA程式碼的唯一產生雜湊。

CC-D2-F3-9C-58-48-04-E4-16-5B-B6-44-B3-EB-EB-FE 參考 問題描述和說明內容的連結(如果有的話)。

https://technet.microsoft.com/library/cc178954.aspx FileStatus 已處理的檔案狀態的分類。

受密碼保護 64位元 指定識別的問題是否為特定於64位元。

是 UserHash 檔案的使用者。

KatharineCruz DeviceName 在其中執行掃描的電腦名稱。

Laptop01 原始程式碼 在巨集中找到VBA程式碼，這可能會導致移至64位元版本Office時發生問題。

PrivateDeclareFunctionFindWindowLib"user32"Alias"FindWindowA"(ByVallpClassNameAsString,ByVallpWindowNameAsString)AsLong 建議變更 對於巨集中的VBA程式碼如何更新才能正確地與64位元版本的Office搭配運作的建議。

1,2 PrivateDeclarePtrSafeFunctionFindWindowLib"user32"Alias"FindWindowA"(ByVallpClassNameAsString,ByVallpWindowNameAsString)AsLongPtr 標籤1 如果已設定，則為自訂標籤的值。

如需詳細資訊，請參閱使用標籤來分類及篩選報告中的資料。

北美 標籤2 如果已設定，則為自訂標籤的值。

如需詳細資訊，請參閱使用標籤來分類及篩選報告中的資料。

舊金山 標籤3 如果已設定，則為自訂標籤的值。

如需詳細資訊，請參閱使用標籤來分類及篩選報告中的資料。

財務 標籤4 如果已設定，則為自訂標籤的值。

如需詳細資訊，請參閱使用標籤來分類及篩選報告中的資料。

控制項 來源檔案參考 進行掃描隱藏檔案名稱的時候，在檔案名稱.log檔裡用來識別檔案名稱的唯一值。

如需詳細資訊，請參閱管理報表中所收集的資料穩私權。

9FE4E090A33CDA8F4502E7E5672464C8F40E79E353DC98FF8CA84846C7D99822 RT版本 執行此掃描的電腦上安裝整備工具組版本 1.0.0.0 1如需針對64位元版本的Office撰寫VBA程式碼的詳細資訊，請參閱64位元VisualBasicforApplications概觀。

2重要事項：所有建議變更都是以現狀提供，不含保固或保證。

當您更新VBA巨集程式碼時，驗證所有變更都如預期般運作相當重要。

增益集報告 下表提供增益集報告中顯示的不同索引標籤(工作表)的清單。

工作表名稱 內容 增益集摘要 提供整備報告建立工具找到的增益集的高階概觀。

工作表頂端的資料是要讓您快速評估有多少增益集與Microsoft365應用程式相容，以及有多少增益集還需要您進行更多研究。

增益集詳細資料 提供所找到的增益集的相關中繼資料資訊(例如，發行者和版本編號)、每個增益集的安裝總數，以及(如果是進階報告)整備狀態(例如，「支援的版本可用」)。

依據電腦名稱 提供增益集詳細資料工作表上的類似資訊，但是會列出增益集安裝所在的每一部電腦，而不只是增益集的安裝總數。

您可以調整增益集報告中顯示的資訊，方法是從[增益集摘要]索引標籤上的下拉式清單選取選項，然後重新整理報告。

例如，您可以調整報告只顯示Access和Excel增益集的相關資訊。

根據預設，不會顯示Office隨附的增益集。

如果您想要查看這些增益集的資訊，請從下拉式清單選取[是]，然後重新整理報告。

但是，大部分企業不需要擔心Office隨附增益集的應用程式相容性。

如果您正在收集增益集使用狀況資訊並只想看到使用中的增益集相關資訊，您可以從下拉式清單中選取「是的」並重新整理報表。

如果您計劃部署64位元版本的Microsoft365Apps，請務必從下拉式清單選取[64位元]，然後重新整理報告。

這樣會提供增益集的64位元特定整備資訊。

預設的報告選項是32位元。

下表列出您可以在增益集報告中看到的可能整備狀態，以及每個狀態代表什麼的說明。

整備狀態 說明 高度採用 這個增益集在其他組織中廣泛用於Microsoft365應用程式，並已準備好搭配Microsoft365應用程式使用。

但是軟體提供者未正式在Microsoft365應用程式上支援增益集。

採用 這個增益集在其他組織中用於Microsoft365應用程式，但是軟體提供者未正式在Microsoft365應用程式上支援增益集。

採用版本可用 這個增益集的不同版本在Microsoft365應用程式上是「採用」或「高度採用」。

請連絡軟體提供者 這個增益集可能會有Microsoft365Apps的問題。

您需要決定這個增益集是否為業務關鍵，然後與軟體提供者連絡以取得指導方針。

支援的版本可用 軟體提供者現在提供適用於Microsoft365應用程式的此增益集支援版本。

未知1,2 這個增益集對於Microsoft是未知。

例如，它可能是您的內部應用程式開發小組建立的企業營運增益集。

如果您建立基本報告，所有增益集的整備狀態會列為「未知」。

只有當您建立進階報告時，整備報告建立工具才會連絡Microsoft以嘗試取得增益集的整備狀態。

資料不足2 Microsoft已經發現這個增益集，但是未收集足夠資訊以提供此增益集的整備狀態。

1預設隨附於Office的部分增益集目前在增益集整備報告中標示為「未知」。

這些增益集實際上是「高度採用」且受到Microsoft支援。

以下是這些增益集的名稱：增益集的ActionsPane結構描述、分析工具箱、分析工具箱-VBA、日期(XML)、適用於MicrosoftOffice2016的交談歷程記錄增益集、歐元工具、即時訊息連絡人(英文)、度量轉換程式(MeasurementConverter)、Microsoft執行窗格3、適用於MicrosoftOffice2016的Skype會議增益集、規劃求解增益集、電話號碼(XML)及時間(XML)。

2如需詳細資訊，請參閱針對分類為「未知」或「資料不足」的增益集所採取的可能步驟。

詳細增益集資訊：增益集報告中的[增益集詳細資料]和[依據電腦名稱]索引標籤都包含類似的資訊資料行。

下表提供這些資料行的清單，以及這些資料行所包含資訊的說明。

資料行名稱 說明 電腦名稱 安裝增益集所在的電腦名稱。

此資料行只會顯示在[依據電腦名稱]索引標籤上。

增益集名稱 增益集的名稱。

增益集發行者 增益集發行者的名稱。

增益集版本 增益集的版本。

應用程式 增益集在其中使用的Office應用程式。

例如，Word或Excel。

安裝總計 增益集的安裝總數。

此資料行只會顯示在[增益集詳細資料]索引標籤上。

整備狀態(32位元) 增益集的整備狀態。

僅限進階報告。

請參閱上方表格以取得可能整備狀態的清單。

附註：如果您從[增益集摘要]索引標籤上的下拉式清單選擇[64位元]，此資料行名稱會改為顯示[(64位元)]。

註解 增益集整備狀態相關的其他資訊(如果有的話)。

僅限進階報告。

詳細資訊 增益集相關其他整備資訊的連結。

僅限進階報告。

總裝置安裝 增益集安裝所在的裝置數目。

收集增益集使用狀況資訊時才可用。

如需詳細資訊，請參閱收集並顯示報告中的增益集使用狀況資訊。

使用增益集的裝置總數 從您開始收集增益集使用狀況資訊起已經使用的增益集裝置數目。

收集增益集使用狀況資訊時才可用。

如需詳細資訊，請參閱收集並顯示報告中的增益集使用狀況資訊。

自從{date}開始使用的增益集 自從您開始收集增益集使用狀況資訊起，增益集是否已被使用的指示。

收集增益集使用狀況資訊時才可用。

如需詳細資訊，請參閱收集並顯示報告中的增益集使用狀況資訊。

取得企業中多位使用者的整備資訊 在單一使用者的電腦上安裝及執行整備報告建立工具來建立整備報告很容易。

但是如果您是在大型組織中，而且需要為整個部門或分公司建立整備報告呢？ 除了UI精靈版本的整備報告建立工具以外，還有可以從命令列執行或搭配指令碼使用的獨立可執行檔。

它的名稱是ReadinessReportCreator.exe且位於整備工具組安裝所在的資料夾中。

如果您讓您的使用者執行UI精靈版本的整備報告建立工具，您最終會有個別Excel檔案，每個使用者一個檔案。

如此一來就會難以從部門或整個辦公室的觀點查看整備程度。

您還必須依賴使用者執行整備報告建立工具並且正確遵循指示。

更好的替代方式是使用整備報告建立工具的命令列功能，並且使用指令碼來執行整備報告建立工具以代表使用者收集資訊。

您可以將整備報告建立工具建立的檔案儲存到網路共用。

如果您這麼做，請確定已將適當的寫入權限授與共用。

注意 如果您使用MicrosoftEndpointConfigurationManager或類似企業軟體部署工具來執行整備工具組，請務必部署使用使用者內容(而非系統內容)的套件。

否則，整備工具組將無法在電腦上的目前使用者的登錄hive中讀取最近使用(MRU)資訊。

您可以藉由開啟命令提示字元、瀏覽到您安裝整備工具組所在的資料夾，然後輸入下列命令，看到可用命令列選項的清單： ReadinessReportCreator.exe-help 命令列版本的整備報告建立工具沒有與UI精靈版本相同的所有功能。

您可以使用命令列版本來掃描最近使用的Office文件和電腦上的已安裝增益集，或者本機資料夾或網路共用中的Office文件。

以下是您可以執行以掃描VBA巨集和增益集，並且將結果儲存到「財務」部門網路共用的命令列範例。

請注意，您必須在命令列中包含addinscan選項，增益集掃描才會發生。

ReadinessReportCreator.exe-mru-addinscan-output\\server01\finance-silent 以下是您可以執行以掃描使用者最近使用的Office文件，並且將結果儲存到「財務」部門網路共用的命令列範例。

這個選項只會掃描VBA巨集。

ReadinessReportCreator.exe-mru-output\\server01\finance-silent 以下是您可以執行以掃描資料夾及其所有子資料夾，並且將結果儲存到「財務」部門網路共用的命令列範例。

這個選項只會掃描VBA巨集。

ReadinessReportCreator.exe-pc:\officefiles\-r-output\\server01\finance-silent 請務必注意，當您從命令列執行整備報告建立工具時，整備報告建立工具不會建立Excel檔案。

整備報告建立工具會改為建立JSON檔案，其中包含來自掃描的VBA巨集和增益集資訊。

若要從這些不同的命令列掃描建立彙總Excel報告，您必須執行UI精靈版本的整備報告建立工具。

針對資訊來源，請選取[先前整備結果一起儲存在本機資料夾或網路共用]，然後選取您儲存所有掃描檔案的位置。

然後整備報告建立工具會從JSON檔案將資訊合併至單一Excel檔案中的整備報告。

請注意，整備報告建立者會在Excel工作表的個別資料列中列出每個Office文件的問題。

因此，整備報告建立者只能傳回1,046,575個結果。

如果您希望超過這些限制，建議您縮小報告的範圍，比方說限制在特定部門。

或者，SQL的匯出選項對於可容納的結果數目沒有限制，如果您希望有大量結果，則這可能是合適的選擇。

根據預設，整備Toolkit所需掃描檔案逾時而並將移至另一個檔案之前的2分鐘。

您可以使用-t選項從命令列來允許整備Toolkit超過2分鐘来掃描的檔案。

使用SQLServer來儲存報告結果 從版本1.2.19098(2019年4月9日版本)開始，您可以將報告資料匯出到任何受支援的SQLServer或SQLServerExpress版本。

此功能為許多客戶的意見反應的回應結果，這些客戶在執行整備工具組報告時需要更大的規模和更大的彈性。

您可以使用[整備報告建立工具]精靈或命令列。

如果您使用的是[整備報告建立工具]，請選取[本機資料夾中的Office文件]或[將之前的整備結果一起儲存在本機資料夾或網路共用]選項。

然後，在[報告設定]頁面上，選取[SQLServer報告]。

提供必要的認證，以及您想要使用的資料庫名稱。

如果資料庫不存在，則會建立資料庫。

會建立具有相同資訊的PowerBI報告，而不是建立Excel文件，以便您檢閱結果。

可展開或視需要變更此PowerBI報告。

它的文件副檔名為.pbit，並會儲存到安裝整備工具組的資料夾中，通常會是C:\ProgramFiles(x86)\MicrosoftReadinessToolkitforOffice。

如果在PowerBI中出現提示，請選取[直接查詢]資料存取模式。

如果您使用的是整備報告建立工具的命令列版本，請鍵入ReadinessReportCreator.exe-help以查看使用SQLServer資料庫的相應命令。

例如，您可以使用以下命令，使用名為整備的本機SQL資料庫，並使用SQLServer驗證而不是Windows驗證從財務部門的前一個整備結果建立報告。

ReadinessReportCreator.exe-sqlimport“C:\Reports\Finance”-serverlocalhost/SQLEXPRESS-databaseReadiness-usernameOfficeadmin-passwordseCRet123$%^ 使用標籤來分類及篩選報告中的資料 您可以指定最多四個自訂標籤，來分類及篩選整備工具組所建立報告中的資料。

報告中可用的標籤是根據最近使用Office文件和使用者電腦上已安裝增益集的掃描。

您可以為自訂標籤指定任何字串。

例如，您可以使用標籤來表示使用者的部門、職銜或地理位置。

當整備工具組在使用者的電腦上執行時，系統會收集自訂標籤並且讓標籤可用於所建立的報告中。

例如，您可以篩選報告，只顯示來自「財務部門」的資料或只顯示來自非洲辦公室的資料。

以一致的方式指派標籤，例如針對部門一律使用「標籤1」。

您可以藉由使用指定自訂標籤以與整備工具組搭配使用群組原則設定來指定這些標籤。

您可以在「使用者設定\原則\系統管理範本\MicrosoftOffice2016\整備工具組」底下找到這個原則設定。

請務必下載最新的Office系統管理範本檔案(ADMX/ADML)。

注意 如果您是使用Office遙測儀表板並且已經設定標記(標籤)，整備工具組會在它掃描使用者電腦期間自動收集這些標籤，並且使其可用於報告中。

但是，您為整備工具組指定的標籤不會出現在Office遙測儀表板中。

管理報告中收集資料的隱私權 對使用者來說在一個組織裡使用含有敏感或機資訊的檔案名稱來儲存Office檔案十分常見。

若要保護使用者隱私權並協助防止揭示敏感資訊，整備工具組可讓您建立一份報告，此報告可隱藏檔案路徑並且隱藏在掃描期間所識別的文件名稱。

您可以從UI精靈或從命令列中藉由執行整備報告建立者來建立隱藏這項資訊的報表。

如果您正在使用UI精靈，首先請在「最近使用的Office文件和這部電腦上安裝的增益集」或「在本機資料夾或網路共用的Office文件」中選擇其中一個作為您要建立的報表類型。

然後，在繼續下一步之前，請在精靈的[下一步]頁面上選取[隱藏檔案名稱和路徑]的核取方塊。

。

如果您要使用命令列建立報告，請使用-隱藏名稱選項，如下列範例所示。

ReadinessReportCreator.exe-mru-addinscan-output\\server01\finance-silent-concealnames 當您建立一份隱藏檔案路徑和文件名稱的報告時，只有剩餘的字元是磁碟機代號、檔案名稱及副檔名的前兩個字元。

其他檔案路徑的字元最多到8字元，並且檔案名稱已取代為星號(*)。

例如：「c:\mergersinfo\Q4\companyx.docx」會顯示為「c:\********\co******.docx」。

當建立報表時，執行掃描的電腦上會建立檔案名稱.log的檔案。

這個檔案包含一個已掃描完且沒有任何隱藏資訊的完整清單的檔案路徑和名稱。

記錄檔也包含列出每個檔案的參照代碼。

此參照代碼出現在所建立報表中的一個欄位裡。

這可讓您在報告中識別特定的檔案，以防報表中辨識需要進一步調查的VBA巨集或增益集問題。

儲存檔案名稱.log的檔案至使用者的AppData資料夾中的暫存資料夾。

例如，針對user01、儲存此檔案至C:\Users\user01\AppData\Local\ReadinessToolkitTemp\資料夾。

在報告中收集並顯示增益集的使用狀況資訊 如果您想深入了解組織最常使用哪些增益集或哪些人經常使用相關的增益集，您可以使用整備工具組收集增益集的使用情況資訊並將其納入整備報表。

Tocollectadd-inusageinformation,installthemostcurrentversionoftheReadinessToolkitoneachcomputerthatyouwanttocaptureadd-inusageinformationfrom.Toenabletheagentthatgeneratesandcollectstheadd-inusageinformation,youneedtoenablethe"Allowadd-inusagedatatobegeneratedandcollectedbytheReadinessToolkit"GroupPolicysetting.ThispolicysettingisavailableinthemostcurrentversionoftheAdministrativeTemplatefiles(ADMX/ADML)forOfficethatareavailableontheMicrosoftDownloadCenter.ThispolicysettingisfoundunderUserConfiguration\Policies\AdministrativeTemplates\MicrosoftOffice2016\ReadinessToolkit. 其所生成和收集的資料包括增益集載入和使用的時間，以及增益集的故障情況。

此資訊將儲存在執行使用代理程式的電腦登錄檔中。

我們建議您讓使用代理程式執行至少30天的時間，以確保您清楚掌握使用者及其使用行為。

監視期間結束後，建立一份整備報表，以收集資訊並將其顯示在報表中。

在您取得所需資訊後，即可變更群組原則設定，並關閉使用代理程式。

注意 在此版本的整備工具集中，執行Office2016的電腦並未收集增益集的使用情況資訊。

偵測Silverlight或Flash控制項 Microsoft365Apps將停用並封鎖Silverlight、ShockwaveFlash及MacromediaFlash控制項。

如需了解更多資訊，請閱讀此技術社群的貼文。

若要識別涵蓋各該控制項的Office檔案，您可以選擇在您建立一份整備報表時掃描所有的Office文件。

這將掃描所有的Office檔案，即便這些檔案並不包含巨集。

由於一次需要掃描多個檔案，因此建立報表將耗費更長的時間。

如何將掃描雲端架構檔案 預設情況下，整備報告建立者無法掃描儲存在SharePoint文件庫、OneDrive或一些其他類型的雲端儲存位置的檔案。

如果您嘗試掃描其中一個檔案，檔案會在報告中顯示為「雲端式」。

其中一項可行的因應措施是掃描這些雲端架構檔案在使用者電腦上的本機快取。

如果檔案只儲存在雲端位置，您可以建立一個與OneDrive或SharePoint共用位置相互對應的網路磁碟機。

然後，您就可以讓整備報告建立者掃描該磁碟機。

但是，掃描此位置時，您必須把檔案下載到記憶體中，以便執行掃描。

根據相關檔案的數量和大小，掃描相關檔案可能耗費大量時間，並用盡網路頻寬。

掃描Office文件以查看巨集簽章問題 為了增強OfficeVBA簽章專案簽署的安全性，Microsoft提供了更安全的VBA專案簽章方案版本：V3簽章。

我們建議組織將V3簽章套用至所有巨集，以消除竄改的風險。

您可以使用整備工具組尋找組織中應升級以使用V3簽章的現有已簽署VBA檔案。

若要尋找這些檔案，請從已提升權限的命令提示字元執行ReadinessReportCreator，並使用sigscan選項。

下列範例命令列會掃描vba_files資料夾中的檔案，並且將在vba_results資料夾中建立JSON檔案，並包含掃描結果。

ReadinessReportCreator.exe-sigscan-pC:\vba_files-r-outputC:\vba_results 若要在Excel中檢視結果，請執行整備工具組，在[建立整備報告]頁面上，選取[先前已一起儲存於本機資料夾或網路共用中的整備報告]。

然後，在命令列中指定使用sigscan所建立JSON檔案，並完成整備工具組精靈中的步驟。

注意 若要使用sigscan，您必須至少使用2021年3月19日發行之整備工具組的版本1.2.21067。

有關詳細資訊，包括如何將這些檔案升級為使用V3簽章，請參閱將已簽署的OfficeVBA巨集專案升級至V3簽章。

其他資訊 針對VBA巨集分析的檔案副檔名 下表依據應用程式列出當整備報告建立工具在Office文件中尋找VBA巨集時，所分析的檔案副檔名。

Application 檔案副檔名 Access accdb、accdt、mdb Excel xla、xlam、xls、xlsm、xlsx、xlt、xltm、xltx Outlook otm PowerPoint pot、potm、potx、ppa、ppam、pps、ppsm、ppt、pptm、pptx、sldx、sldm Project mpp、mpt Publisher pub Visio vsd、vsdx、vsdm Word doc、docm、docx、dot、dotm、dotx 整備報告建立工具會收集其資料的增益集類型 下表列出整備報告建立工具會收集其資料的增益集類型。

系統會識別所有Office應用程式的增益集，但是不包含Web增益集。

對於我們看到在Microsoft365應用程式中執行的COM增益集，也會提供整備資訊。

增益集類型 Office應用程式 描述 自動化 Excel 支援Excel的自動化增益集是依據COM增益集所建置。

可以從Excel工作表中的公式呼叫自動化增益集中的函數。

COM Excel、Outlook、PowerPoint及Word COM增益集包含通常是以C++和使用受控程式碼開發的VisualStudioToolsforOffice(VSTO)撰寫的增益集。

VBA Excel、PowerPoint和Word VBA增益集是包含VBA程式碼之應用程式專用的檔案，包括啟用巨集的Word範本(.dotm)、Excel增益集(.xla、.xlam)及PowerPoint增益集(.ppa、.ppam)。

WLL Word WLL(.wll)增益集為Word所特有，且使用任何支援建立DLL的編譯器而建立。

XLL Excel XLL增益集(.xll)為Excel所特有，且使用任何支援建立DLL(動態連結程式庫)的編譯器而建立，無須進行安裝或註冊。

XLL增益集亦包括含有使用者定義之命令及函數的DLL。

XLSRTD Excel XLS即時資料(RTD)增益集是使用RealTimeData工作表函數來呼叫Automation伺服程式即時擷取資料的Excel工作表。

建立進階報告時，傳送給Microsoft的資訊範例 當您選擇建立進階報告時，某些資訊會傳送給Microsoft。

下表提供傳送給Microsoft，關於在掃描期間找到的VBA巨集的資訊清單，以及範例。

資料 描述 範例 DevicesScanned 已掃描的電腦數目。

DevicesScanned：23 UniqueUsers 掃描中包含的使用者計數。

UniqueUsers：14 規則 特定規則套用到已掃描VBA巨集的次數。

使用GUID以唯一識別規則。

48f05b1d-c8ad-4d0c-9453-1abdf007b2db：2374db65ab-76f3-43fb-997d-0d9750efb527：2 FilesWithIssues 具有相容性問題的唯一檔案計數。

FilesWithIssues:320 FilesWithDuplicateVBA 包含重複巨集的唯一檔案計數。

FilesWithDuplicateVBA：233 FilesWithNoIssuesFound 沒有問題的唯一檔案計數。

FilesWithNoIssuesFound：12 InaccessibleFiles 無法存取的唯一檔案計數。

InaccessibleFiles：4 FilesPasswordProtected 受密碼保護的唯一檔案計數。

FilesPasswordProtected：123 FilesLocked 已鎖定的唯一檔案計數。

FIlesLocked：0 FilesWithVBA 具有VBA的唯一檔案計數。

FilesWithVBA：122 FilesWithoutVBA 沒有VBA的唯一檔案計數。

FilesWithoutVBA：11 Significantremediationrequired 需要大量修復的唯一檔案計數。

Significantremediationrequired：12 Limitedremediationrequired 需要有限修復的唯一檔案計數 Limitedremediationrequired：12 Minimalvalidationrequired 需要基本驗證的唯一檔案計數。

Minimalvalidationrequired：22 CodeDesignChanges 包含使用我們建議變更的功能的唯一檔案計數。

CodeDesignChanges：1 DevicesWithNoMacros 未啟用巨集的裝置數目。

DevicesWithNoMacros:12 DevicesWithDeclares 巨集包含Declare陳述式的裝置數目。

DevicesWithDeclares:12 DevicesWhichRequireSignificantRemediation 包含巨集檔案須作重大修復的裝置數目。

DevicesWhichRequireSignificantRemediation:12 DevicesBlockedFromUpgrade 包含巨集須作修復以解除封鎖並升級至Microsoft365應用程式的裝置數目。

DevicesBlockedFromUpgrade:1 DevicesWithMacrosWithIssues 包含巨集出現相容性問題的裝置數目。

DevicesWithMacrosWithIssues:2 DevicesWhichRequireLimitedRemediation 包含巨集檔案須作重大修復的裝置數目。

DevicesWhichRequireLimitedRemediation:12 DevicesWhichRequireMinimalValidation 包含巨集檔案須作最小驗證的裝置數目。

DevicesWhichRequireMinimalValidation:12 DevicesWithMacrosWithoutIssues 包含巨集但無任何相容性問題的裝置數目。

DevicesWithMacrosWithoutIssues:12 DevicesWithMacros 包含巨集檔案的裝置數目。

DevicesWithMacros:12 DevicesSafeToUpgrade 可升級至Microsoft365應用程式的裝置數目。

DevicesSafeToUpgrade:12 DevicesWithOlderToolVersion 使用舊版整備工具組的裝置數目。

DevicesWithOlderToolVersion:12 下表提供傳送給Microsoft，關於在掃描期間找到的增益集的資訊清單，以及範例。

資料 範例 增益集程式識別碼 UCAddin.LyncAddin.1 易記名稱 適用於MicrosoftOffice2016的Skype會議增益集(Outlook) 描述 適用於MicrosoftOffice2016的Skype會議增益集 檔案名稱 UCADDIN.DLL 增益集CLSID {A6A2383F-AD50-4D52-8110-3508275E77F7} 提供者 MicrosoftCorporation 檔案戳記 1499940832 檔案版本 16.0.8326.2044 Office應用程式 Outlook 裝置數量 35 變更巨集設定，以檢視整備報告中的資訊 整備報告建立工具建立的報告會使用巨集和主動式內容，以在報告中顯示資訊。

因此，若要在報告中查看VBA巨集相容性和增益集整備資訊，您必須在Excel中允許巨集和主動式內容。

如果未在Excel中啟用巨集和主動式內容，您會在開啟報告時，於[概觀]工作表上看到[開始使用]訊息。

該頁面上有如何啟用巨集和主動式內容的指示。

這與在訊息列中按一下[啟用內容]一樣簡單。

在某些情況下，您可能不會看到訊息列和[啟用內容]選項。

這種情形最有可能發生，因為Excel是設定為停用所有巨集且沒有通知。

您可以藉由移至[檔案]>[選項]>[信任中心]>[信任中心設定…]>[巨集設定]來檢查此設定。

在[信任中心]對話方塊中，您可以將設定變更為[停用所有巨集並且通知]。

在您這麼做之後，選擇[確定]以儲存變更並且關閉[信任中心]對話方塊，然後選擇[確定]以關閉[Excel選項]對話方塊，然後關閉報告檔案。

當您再次開啟報告檔案時，您應該會看到訊息列和[啟用內容]選項。

如果[信任中心]對話方塊中的巨集設定選項呈現灰色，則是系統管理員已經使用群組原則進行設定，且設定無法手動變更。

在這種情況下，最簡單的解決方案是在與執行Excel巨集設定不同的電腦上開啟報告檔案，讓您藉由選取訊息列中的[啟用內容]選項來啟用巨集。

如需巨集設定選項的詳細資訊，請參閱在Office檔案中啟用或停用巨集。

針對分類為「未知」或「資料不足」的增益集所採取的可能步驟 如果增益集分類為「未知」或「資料不足」，則表示Microsoft尚未有與增益集相關的足夠資訊可以提供整備狀態。

如果這是組織的商務關鍵性增益集，您可以執行下列動作： 請與開發此增益集的軟體提供者聯繫，確認此增益集是否支援Microsoft365應用程式。

請透過[email protected]與我們連絡。

我們會竭盡所能將增益集的整備狀態新增至我們的資料庫。

請盡可能提供增益集的相關資訊，包括但不限於下列項目： 易記名稱 檔案版本 軟體提供者 下載連結，或有關如何下載及安裝增益集的任何詳細資料。

其他詳細資料，例如增益集的類型、增益集與哪個Office應用程式搭配使用、程式識別碼或CLSID。

傳送給Microsoft的錯誤報告資訊 如果顯示整備報告時發生問題，您會收到訊息，詢問您是否想要傳送錯誤報告給Microsoft。

例如，如果在報告中建立圖表時或查詢收集的資料時發生問題。

藉由傳送錯誤報告給Microsoft，您可以協助我們改善整備工具組。

傳送給Microsoft的錯誤報告不會包含任何可識別個人的資訊。

下表提供傳送給Microsoft的錯誤報告中包含哪些資訊的清單。

傳送的資料 描述 模組 發生錯誤的VBA模組。

子/函數名稱 發生錯誤的子程序或函數的名稱。

行識別碼 最後成功執行的程式碼行開頭的識別碼。

錯誤訊息 使用者訊息通常會依據錯誤輸出。

可能會針對某些錯誤當地語系化。

錯誤編號 識別錯誤的編號。

來源名稱 引發錯誤的物件名稱。

這不是變數名稱。

工具版本 所使用的整備工具組版本。

報告GUID 針對每個報告產生的GUID有助於篩選出重複的錯誤。

工作階段識別碼 當建立報告來讓它與整備工具組所記錄的任何錯誤相互關聯時的工作階段識別碼。

Excel版本 用來檢視整備報告的Excel版本。

本文內容