使用 Microsoft 365 應用程式整備工具組評估應用程式相容性
Readiness Toolkit for Office add-ins and VBA 可以協助您識別您的 Microsoft Visual Basic for Applications (VBA) 巨集和您與 Office 搭配使用的增益集的相容性問題。整備工具組包括整備報告建立工具,它會建立具有 VBA 巨集相容性和增益集整備資訊的 Excel 報告,協助您的組織評估移至 Microsoft 365 Apps 的整備程度。
您可以從 Microsoft 下載中心免費下載整備工具組。我們建議您一律下載及使用最新版本。當您執行報告時,整備工具組會檢查是否您正在使用的最新版本,並會提示您下載最新的版本。在安裝最新版本前,您不必解除安裝舊版的整備工具組。
重要
整備工具組無法修復或修正您的 VBA 巨集中的程式碼。如果您建立進階報告,報告會在可行時提供修復 VBA 巨集程式碼的指引。
整備報告建立工具可以掃描 Word、Excel、PowerPoint、Outlook、Access、Project、Visio 及 Publisher 檔案中的 VBA 巨集,即使是 Office 2003 這麼舊的 Office 版本。它也可以掃描與 Office 搭配使用的特定類型增益集。可以識別所有 Office 應用程式的增益集,但是不包括 Web 增益集。如需詳細資訊,請參閱針對 VBA 巨集分析的副檔名和整備報告建立工具會收集其資料的增益集類型。
下載項目是 MSI 檔案,您可以用來在使用者的電腦上安裝整備工具組。安裝之後,當您執行整備報告建立工具時,UI 精靈會逐步引導您進行建立整備報告的程序。另外也有可以從命令列執行或透過指令碼來使用的獨立可執行檔。如果您需要以更加自動化的方式收集整個企業中使用者的整備資訊,則獨立可執行檔很有用。如需詳細資訊,請參閱取得企業中多位使用者的整備資訊。
下列資訊可協助您使用整備報告建立工具:
建立整備報告,包括需求和限制,選擇作為基礎來建立報告的資訊,以及基本與進階報告之間的差異。
整備報告中的資訊,適用於 VBA 巨集和增益集整備。
取得企業中多位使用者的整備資訊,並且使用命令列版本的整備報告建立工具來掃描多部電腦。
使用SQL Server 儲存報告結果並使用 Power BI 分析報告結果,以克服使用 Excel 的一些限制,尤其是對於包含大量資料的報告。
使用標籤來分類及篩選報告中的資料可協助您分析您的組織的整備程度並且進行決策。
管理報表中所收集資料的隱私權可讓您知道如何隱藏檔案路徑和名稱的機密資訊。
收集並顯示在報告中的增益集使用資訊 可以更了解您的組織中最常使用哪些增益集以及是誰使用這些了增益集。
其他資訊,包括整備報告建立工具分析的副檔名、整備報告建立工具會收集其資料的增益集類型,以及當建立進階報告時傳送給 Microsoft 的資訊範例。
注意
- 許多企業在執行 Readiness Toolkit 後,發現相容性問題比之前的預計要少。以企業版所提供的資料為基礎來執行 Readiness Toolkit ,平均 6% 的掃描檔案有巨集,而這些檔案中的 3.3% 有巨集問題。所以這代表僅有 0.2% 的檔案有巨集相容性問題。在 Office 增益集中,已找到的 75% 被分類為採用或支援。
- 如果您有關於整備工具組的意見反應或問題,請傳送電子郵件到 ReadyForOffice@microsoft.com 與我們連絡。
建立整備報告
使用整備工具組的需求和限制
在安裝及使用整備工具組之前,您應該注意下列需求:
Windows 7 Service Pack 1 (SP1) 或更新版本
Microsoft .NET Framework 4.5.1 或更新版本
Excel 2010 或更新版本
Microsoft Access Database Engine 2010 可轉散發套件 (只有在您是使用隨選即用版本的 Access 時才適用)
注意
- 我們建議使用 64 位元版本的 Excel,特別是當您預期在整備報告中有超過 400,000 筆結果時。
- Windows 7 和 Excel 2010 已不再支援產品。
此外,您還應該了解整備報告建立工具的一些限制:
整備報告建立工具無法掃描受密碼保護的檔案,如果您嘗試掃描此類檔案,檔案會在報告中顯示為「受密碼保護」。
預設情況下,整備報告建立者無法掃描儲存在 SharePoint 文件庫、OneDrive 或一些其他類型的雲端儲存位置的檔案。如果您嘗試掃描此類檔案,檔案會在報告中顯示為「雲端式」。如需可能的因應措施,請參閱如何掃描雲端式的檔案。
整備報告建立工具會在 Excel 工作表的個別資料列中列出 Office 文件的每個問題。因此,整備報告建立工具只能傳回 1,046,575 筆結果。如果您預期會超過這個限制,我們建議您將報告的範圍縮小,例如縮小為特定部門。
選擇要用來建立報告的資訊
若要建立整備報告,首先您需要選擇用來建立報告的資訊。下表列出可能的選項和每個選項的說明。它也會指定各個選項會建立哪種類型的整備報告。
選項 | 說明 | 建立的報告 |
---|---|---|
這部電腦上最近使用的 Office 文件和已安裝增益集 |
整備報告建立工具只會掃描使用者最近使用檔案清單中的 Office 文件。這樣可以讓您將掃描焦點縮小到使用者定期存取的文件上。 此外,整備報告建立工具會尋找在整備報告建立工具執行所在的電腦上安裝的任何 Office 增益集。 |
VBA 和增益集 |
本機資料夾或網路共用中的 Office 文件。 |
整備報告建立工具會掃描您指定的資料夾或網路共用中的 Office 文件。整備報告建立工具會自動掃描指定位置及該位置中的所有子資料夾。 附註: 使用此選項,整備報告建立工具就不會尋找安裝在整備報告建立工具執行所在電腦上的增益集。 |
僅限 VBA |
先前的整備結果會一起儲存在本機資料夾或網路共用。 |
此選項可讓您建立由多部獨立電腦的個別整備結果所組成的彙總報告。 例如,您可能會在「財務」部門的所有電腦上執行整備報告建立工具,將每個掃描的結果儲存至網路共用。然後,您可以使用此選項來建立「財務」部門的彙總報告。 如需詳細資訊,請參閱取得企業中多位使用者的整備資訊。 |
僅限 VBA 或 VBA 和增益集,取決於使用哪個整備結果。 |
來自 Office 遙測儀表板的增益集資料。 |
如果您使用 Office 遙測儀表板評估增益集相容性,您可以使用您收集的資訊來建立整備報告。您只需要將用來存取 Office 遙測儀表板資料庫的適當資訊提供給整備報告建立工具。 附註: 使用此選項,整備報告建立工具就不會尋找 VBA 巨集。要執行此選項的使用者需要有資料庫上的 GRANT SELECT 存取權。 |
僅限增益集 |
在基本與進階報告之間選擇
在您選取要用什麼資訊來建立報告並且指定儲存報告的位置之後,您必須選擇要建立基本報告或進階報告。
我們強烈建議您建立進階報告,因為進階報告提供額外的資訊,可以協助您評估您的 VBA 巨集和增益集與 Microsoft 365 Apps 的相容性。例如,您會在進階報告中取得下列額外資訊:
針對在您的 VBA 巨集中找到的問題的補救建議 (如果有的話)。此資訊會顯示在報告的個別工作表中。
增益集的整備狀態。例如,報告可能會顯示軟體提供者有 Microsoft 365 應用程式增益集的支援版本。
增益集的整備狀態是從以遙測為基礎的計算衍生而來,並且明確支援來自 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 位元版本的 Microsoft 365 應用程式,請確定已勾選 [包含 64 位元整備資料] 核取方塊,並且已重新整理報告。 |
VBA 摘要 |
提供一些預先定義的樞紐分析表,讓您分析從掃描擷取的資料。 如果這些樞紐分析表不符合您的特定需求,您可以根據 VBA 結果工作表上的資料自行建立。 |
VBA 結果 |
提供整備報告建立工具掃描的每個檔案的資訊。如果在掃描的檔案中找到多個問題,每個問題都有個別資料列。 請參閱本節結尾「詳細 VBA 資訊」標題底下的表格,以取得每個欄位中顯示資訊的說明。 |
VBA 修復 |
提供掃描期間找到的 VBA 巨集程式碼的建議變更。 請參閱本節結尾「詳細 VBA 資訊」標題底下的表格,以取得每個欄位中顯示資訊的說明。 |
VBA 參考 |
列出在程式碼和 VBA 專案中識別的參考。這些參考通常會用於呼叫外部 DLL、連結檔案及 VBA 程式碼所使用的 ODBC 連線。 請參閱本節結尾「詳細 VBA 資訊」標題底下的表格,以取得每個欄位中顯示資訊的說明。 |
檔案狀態: 報告也會依據檔案狀態對掃描的檔案進行分類。下表列出整備報告中顯示的可能檔案狀態,以及檔案狀態的說明。
檔案狀態 | 說明 |
---|---|
沒有 VBA |
已掃描檔案,找不到任何 VBA 巨集程式碼。 |
具有 VBA |
已掃描檔案,找到 VBA 巨集程式碼。 |
雲端式 |
無法掃描檔案,因為它儲存在 SharePoint 文件庫、OneDrive 或某些其他類型的雲端式儲存位置。 |
受密碼保護 |
檔案受密碼保護,所以它不會針對 VBA 巨集進行掃描。 |
無法存取 |
因為某些原因而無法掃描檔案,例如整備報告建立工具沒有足夠權限可以存取檔案、檔案已損毀,或者檔案使用很舊的 Office 檔案格式。 |
無法存取 - 需要驅動程式 |
無法掃描檔案,因為在執行掃描的電腦上未安裝必要的 Microsoft Access Database Engine 2010。 |
鎖定 |
執行掃描時檔案已鎖定或在使用中。 |
錯誤 |
掃描期間嘗試讀取的 VBA 程式碼串流不是有效格式。有時候開啟然後儲存支援 Office 版本的檔案,可讓整備報告建立工具掃描檔案。 |
嚴重性等級: 報告會依據嚴重性等級對 VBA 巨集中找到的問題進行分類,協助您估計解決所找到的問題需要多少努力。如果找到多個 VBA 巨集的問題,報告會在圓形圖中顯示最高的嚴重性等級。
下表列出整備報告中顯示的可能嚴重性,以及嚴重性等級的說明。
嚴重性 | 說明 |
---|---|
準備升級 |
在此檔案中找不到問題,且該檔案與 Microsoft 365 應用程式相容。 |
程式碼設計認知 |
程式碼將會如預期般運作,而且使用者不太會發現任何變更、功能、屬性或方法的運作方式與先前版本不同,或者可能在較新版本中已遭到取代。 |
建議的基本驗證 |
預期不會有執行階段或編譯時間錯誤,但是 API 功能可能已經以某種方式變更。建議使用者對 Microsoft 365 Apps 的檔案執行快速檢查,以確定檔案持續如預期般運作。若要將環境問題降至最低,理想情況是在經常執行巨集的電腦上執行快速檢查。 |
需要有限修復 |
需要某些程序碼重構。但是會有一個清楚的取代動作,因此預期修正巨集所需的工作會大量減少。 |
需要大量修復 |
需要大量程式碼重構,讓程式碼繼續如舊版 Office 版本一樣運作。例如,API 已遭到取代,但是未提供取代的功能。在此情況下,唯一的可用選項是重新建立功能。 |
詳細 VBA 資訊: VBA 整備報告中的 [VBA 結果]、[VBA 修復] 和 [VBA 參考] 索引標籤都包含類似的資訊資料行。下表提供這些資料行的清單,以及這些資料行所包含資訊的說明。
資料行名稱 | 說明 | 範例 |
---|---|---|
指導方針 |
掃描文件時識別的指導方針 (規則)。 |
Access 2013 中不再有程式工具列和功能表列。 |
嚴重性 |
所識別問題的嚴重性。 |
需要大量修復 |
來源位置 |
已掃描檔案的位置。 |
D:\我的文件\我的檔案\ |
來源檔案 |
已掃描檔案的名稱。 |
MyFileName.xlsx |
來源檔案雜湊 |
檔案的唯一產生雜湊。 |
36426A0DCFC06F6425E205F107A5CA58 |
來源檔案副檔名 |
已掃描檔案的副檔名。 |
.docm |
模組 |
在其中識別程式碼問題的模組名稱。 |
mDJSCommandBars |
行號 |
在其中識別程式碼問題的行號。 |
112 |
類型 |
已識別的問題類型。 |
VBA |
成員 |
在其中識別問題的 VBA 模組區段名稱 (亦即函數)。 |
CommandBars |
陳述式 |
在其中識別問題的程式碼區段。 |
Dim ctlName As CommandBarControl |
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 |
檔案的使用者。 |
Katharine Cruz |
DeviceName |
在其中執行掃描的電腦名稱。 |
Laptop01 |
原始程式碼 |
在巨集中找到 VBA 程式碼,這可能會導致移至 64 位元版本 Office 時發生問題。 |
Private Declare Function FindWindow Lib "user32" Alias "FindWindowA" (ByVal lpClassName As String, ByVal lpWindowName As String) As Long |
建議變更 |
對於巨集中的 VBA 程式碼如何更新才能正確地與 64 位元版本的 Office 搭配運作的建議。1, 2 |
Private Declare PtrSafe Function FindWindow Lib "user32" Alias "FindWindowA" (ByVal lpClassName As String, ByVal lpWindowName As String) As LongPtr |
標籤1 |
如果已設定,則為自訂標籤的值。如需詳細資訊,請參閱使用標籤來分類及篩選報告中的資料。 |
北美 |
標籤2 |
如果已設定,則為自訂標籤的值。如需詳細資訊,請參閱使用標籤來分類及篩選報告中的資料。 |
舊金山 |
標籤3 |
如果已設定,則為自訂標籤的值。如需詳細資訊,請參閱使用標籤來分類及篩選報告中的資料。 |
財務 |
標籤4 |
如果已設定,則為自訂標籤的值。如需詳細資訊,請參閱使用標籤來分類及篩選報告中的資料。 |
控制項 |
來源檔案參考 | 進行掃描隱藏檔案名稱的時候,在檔案名稱 .log 檔裡用來識別檔案名稱的唯一值。如需詳細資訊,請參閱 管理報表中所收集的資料穩私權。 | 9FE4E090A33CDA8F4502E7E5672464C8F40E79E353DC98FF8CA84846C7D99822 |
RT 版本 | 執行此掃描的電腦上安裝整備工具組版本 | 1.0.0.0 |
1 如需針對 64 位元版本的 Office 撰寫 VBA 程式碼的詳細資訊,請參閱 64 位元 Visual Basic for Applications 概觀。
2 重要事項: 所有建議變更都是以現狀提供,不含保固或保證。當您更新 VBA 巨集程式碼時,驗證所有變更都如預期般運作相當重要。
增益集報告
下表提供增益集報告中顯示的不同索引標籤 (工作表) 的清單。
工作表名稱 | 內容 |
---|---|
增益集摘要 |
提供整備報告建立工具找到的增益集的高階概觀。 工作表頂端的資料是要讓您快速評估有多少增益集與 Microsoft 365 應用程式相容,以及有多少增益集還需要您進行更多研究。 |
增益集詳細資料 |
提供所找到的增益集的相關中繼資料資訊 (例如,發行者和版本編號)、每個增益集的安裝總數,以及 (如果是進階報告) 整備狀態 (例如,「支援的版本可用」)。 |
依據電腦名稱 |
提供增益集詳細資料工作表上的類似資訊,但是會列出增益集安裝所在的每一部電腦,而不只是增益集的安裝總數。 |
您可以調整增益集報告中顯示的資訊,方法是從 [增益集摘要] 索引標籤上的下拉式清單選取選項,然後重新整理報告。例如,您可以調整報告只顯示 Access 和 Excel 增益集的相關資訊。
根據預設,不會顯示 Office 隨附的增益集。如果您想要查看這些增益集的資訊,請從下拉式清單選取 [是],然後重新整理報告。但是,大部分企業不需要擔心 Office 隨附增益集的應用程式相容性。
如果您正在 收集增益集使用狀況資訊 並只想看到使用中的增益集相關資訊,您可以從下拉式清單中選取「是的」並重新整理報表。
如果您計劃部署 64 位元版本的 Microsoft 365 Apps,請務必從下拉式清單選取 [64 位元],然後重新整理報告。這樣會提供增益集的 64 位元特定整備資訊。預設的報告選項是 32 位元。
下表列出您可以在增益集報告中看到的可能整備狀態,以及每個狀態代表什麼的說明。
整備狀態 | 說明 |
---|---|
高度採用 |
這個增益集在其他組織中廣泛用於 Microsoft 365 應用程式,並已準備好搭配 Microsoft 365 應用程式使用。 但是軟體提供者未正式在 Microsoft 365 應用程式上支援增益集。 |
採用 |
這個增益集在其他組織中用於 Microsoft 365 應用程式,但是軟體提供者未正式在 Microsoft 365 應用程式上支援增益集。 |
採用版本可用 |
這個增益集的不同版本在 Microsoft 365 應用程式上是「採用」或「高度採用」。 |
請連絡軟體提供者 |
這個增益集可能會有 Microsoft 365 Apps 的問題。您需要決定這個增益集是否為業務關鍵,然後與軟體提供者連絡以取得指導方針。 |
支援的版本可用 |
軟體提供者現在提供適用於 Microsoft 365 應用程式的此增益集支援版本。 |
未知1,2 |
這個增益集對於 Microsoft 是未知。例如,它可能是您的內部應用程式開發小組建立的企業營運增益集。 如果您建立基本報告,所有增益集的整備狀態會列為「未知」。只有當您建立進階報告時,整備報告建立工具才會連絡 Microsoft 以嘗試取得增益集的整備狀態。 |
資料不足2 |
Microsoft 已經發現這個增益集,但是未收集足夠資訊以提供此增益集的整備狀態。 |
1 預設隨附於 Office 的部分增益集目前在增益集整備報告中標示為「未知」。這些增益集實際上是「高度採用」且受到 Microsoft 支援。以下是這些增益集的名稱:增益集的 ActionsPane 結構描述、分析工具箱、分析工具箱 - VBA、日期 (XML)、適用於 Microsoft Office 2016 的交談歷程記錄增益集、歐元工具、即時訊息連絡人 (英文)、度量轉換程式 (Measurement Converter)、Microsoft 執行窗格 3、適用於 Microsoft Office 2016 的 Skype 會議增益集、規劃求解增益集、電話號碼 (XML) 及時間 (XML)。
2 如需詳細資訊,請參閱針對分類為「未知」或「資料不足」的增益集所採取的可能步驟。
詳細增益集資訊: 增益集報告中的 [增益集詳細資料] 和 [依據電腦名稱] 索引標籤都包含類似的資訊資料行。下表提供這些資料行的清單,以及這些資料行所包含資訊的說明。
資料行名稱 | 說明 |
---|---|
電腦名稱 |
安裝增益集所在的電腦名稱。 此資料行只會顯示在 [依據電腦名稱] 索引標籤上。 |
增益集名稱 |
增益集的名稱。 |
增益集發行者 |
增益集發行者的名稱。 |
增益集版本 |
增益集的版本。 |
應用程式 |
增益集在其中使用的 Office 應用程式。例如,Word 或 Excel。 |
安裝總計 |
增益集的安裝總數。 此資料行只會顯示在 [增益集詳細資料] 索引標籤上。 |
整備狀態 (32 位元) |
增益集的整備狀態。僅限進階報告。 請參閱上方表格以取得可能整備狀態的清單。 附註:如果您從 [增益集摘要] 索引標籤上的下拉式清單選擇 [64 位元],此資料行名稱會改為顯示 [(64 位元)]。 |
註解 |
增益集整備狀態相關的其他資訊 (如果有的話)。僅限進階報告。 |
詳細資訊 |
增益集相關其他整備資訊的連結。僅限進階報告。 |
總裝置安裝 | 增益集安裝所在的裝置數目。 收集增益集使用狀況資訊時才可用。如需詳細資訊,請參閱 收集並顯示報告中的增益集使用狀況資訊。 |
使用增益集的裝置總數 | 從您開始收集增益集使用狀況資訊起已經使用的增益集裝置數目。 收集增益集使用狀況資訊時才可用。如需詳細資訊,請參閱 收集並顯示報告中的增益集使用狀況資訊。 |
自從 {date} 開始使用的增益集 | 自從您開始收集增益集使用狀況資訊起,增益集是否已被使用的指示。 收集增益集使用狀況資訊時才可用。如需詳細資訊,請參閱 收集並顯示報告中的增益集使用狀況資訊。 |
取得企業中多位使用者的整備資訊
在單一使用者的電腦上安裝及執行整備報告建立工具來建立整備報告很容易。但是如果您是在大型組織中,而且需要為整個部門或分公司建立整備報告呢?
除了 UI 精靈版本的整備報告建立工具以外,還有可以從命令列執行或搭配指令碼使用的獨立可執行檔。它的名稱是 ReadinessReportCreator.exe 且位於整備工具組安裝所在的資料夾中。
如果您讓您的使用者執行 UI 精靈版本的整備報告建立工具,您最終會有個別 Excel 檔案,每個使用者一個檔案。如此一來就會難以從部門或整個辦公室的觀點查看整備程度。您還必須依賴使用者執行整備報告建立工具並且正確遵循指示。
更好的替代方式是使用整備報告建立工具的命令列功能,並且使用指令碼來執行整備報告建立工具以代表使用者收集資訊。您可以將整備報告建立工具建立的檔案儲存到網路共用。如果您這麼做,請確定已將適當的寫入權限授與共用。
注意
如果您使用 Microsoft Endpoint Configuration Manager 或類似企業軟體部署工具來執行整備工具組,請務必部署使用使用者內容 (而非系統內容) 的套件。否則,整備工具組將無法在電腦上的目前使用者的登錄 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 -p c:\officefiles\ -r -output \\server01\finance -silent
請務必注意,當您從命令列執行整備報告建立工具時,整備報告建立工具不會建立 Excel 檔案。整備報告建立工具會改為建立 JSON 檔案,其中包含來自掃描的 VBA 巨集和增益集資訊。
若要從這些不同的命令列掃描建立彙總 Excel 報告,您必須執行 UI 精靈版本的整備報告建立工具。針對資訊來源,請選取 [先前整備結果一起儲存在本機資料夾或網路共用],然後選取您儲存所有掃描檔案的位置。然後整備報告建立工具會從 JSON 檔案將資訊合併至單一 Excel 檔案中的整備報告。
請注意,整備報告建立者會在 Excel 工作表的個別資料列中列出每個 Office 文件的問題。 因此,整備報告建立者只能傳回 1,046,575 個結果。 如果您希望超過這些限制,建議您縮小報告的範圍,比方說限制在特定部門。 或者,SQL 的匯出選項對於可容納的結果數目沒有限制,如果您希望有大量結果,則這可能是合適的選擇。
根據預設,整備 Toolkit 所需掃描檔案逾時而並將移至另一個檔案之前的 2 分鐘。您可以使用-t 選項從命令列來允許整備 Toolkit 超過 2 分鐘来掃描的檔案。
使用 SQL Server 來儲存報告結果
從版本 1.2.19098 (2019 年 4 月 9 日版本) 開始,您可以將報告資料匯出到任何受支援的 SQL Server 或 SQL Server Express 版本。 此功能為許多客戶的意見反應的回應結果,這些客戶在執行整備工具組報告時需要更大的規模和更大的彈性。
您可以使用 [整備報告建立工具] 精靈或命令列。 如果您使用的是 [整備報告建立工具],請選取 [本機資料夾中的 Office 文件] 或 [將之前的整備結果一起儲存在本機資料夾或網路共用] 選項。 然後,在 [報告設定] 頁面上,選取 [SQL Server 報告]。 提供必要的認證,以及您想要使用的資料庫名稱。 如果資料庫不存在,則會建立資料庫。
會建立具有相同資訊的 Power BI 報告,而不是建立 Excel 文件,以便您檢閱結果。 可展開或視需要變更此 Power BI 報告。 它的文件副檔名為 .pbit,並會儲存到安裝整備工具組的資料夾中,通常會是 C:\Program Files (x86)\Microsoft Readiness Toolkit for Office。 如果在 Power BI 中出現提示,請選取 [直接查詢] 資料存取模式。
如果您使用的是整備報告建立工具的命令列版本,請鍵入 ReadinessReportCreator.exe -help 以查看使用 SQL Server 資料庫的相應命令。 例如,您可以使用以下命令,使用名為整備的本機 SQL 資料庫,並使用 SQL Server 驗證而不是 Windows 驗證從財務部門的前一個整備結果建立報告。
ReadinessReportCreator.exe -sqlimport “C:\Reports\Finance” -server localhost/SQLEXPRESS -database Readiness -username Officeadmin -password seCRet123$%^
使用標籤來分類及篩選報告中的資料
您可以指定最多四個自訂標籤,來分類及篩選整備工具組所建立報告中的資料。報告中可用的標籤是根據最近使用 Office 文件和使用者電腦上已安裝增益集的掃描。
您可以為自訂標籤指定任何字串。例如,您可以使用標籤來表示使用者的部門、職銜或地理位置。當整備工具組在使用者的電腦上執行時,系統會收集自訂標籤並且讓標籤可用於所建立的報告中。例如,您可以篩選報告,只顯示來自「財務部門」的資料或只顯示來自非洲辦公室的資料。以一致的方式指派標籤,例如針對部門一律使用「標籤 1」。
您可以藉由使用 指定自訂標籤以與整備工具組搭配使用 群組原則設定來指定這些標籤。您可以在「使用者設定\原則\系統管理範本\Microsoft Office 2016\整備工具組」底下找到這個原則設定。請務必下載最新的 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\Readiness Toolkit Temp\ 資料夾。
在報告中收集並顯示增益集的使用狀況資訊
如果您想深入了解組織最常使用哪些增益集或哪些人經常使用相關的增益集,您可以使用整備工具組收集增益集的使用情況資訊並將其納入整備報表。
To collect add-in usage information, install the most current version of the Readiness Toolkit on each computer that you want to capture add-in usage information from. To enable the agent that generates and collects the add-in usage information, you need to enable the "Allow add-in usage data to be generated and collected by the Readiness Toolkit" Group Policy setting. This policy setting is available in the most current version of the Administrative Template files (ADMX/ADML) for Office that are available on the Microsoft Download Center. This policy setting is found under User Configuration\Policies\Administrative Templates\Microsoft Office 2016\Readiness Toolkit.
其所生成和收集的資料包括增益集載入和使用的時間,以及增益集的故障情況。此資訊將儲存在執行使用代理程式的電腦登錄檔中。
我們建議您讓使用代理程式執行至少30天的時間,以確保您清楚掌握使用者及其使用行為。監視期間結束後,建立一份整備報表,以收集資訊並將其顯示在報表中。在您取得所需資訊後,即可變更群組原則設定,並關閉使用代理程式。
注意
在此版本的整備工具集中,執行 Office 2016 的電腦並未收集增益集的使用情況資訊。
偵測 Silverlight 或 Flash 控制項
Microsoft 365 Apps 將停用並封鎖 Silverlight、Shockwave Flash 及 Macromedia Flash 控制項。如需了解更多資訊,請閱讀此技術社群的貼文。
若要識別涵蓋各該控制項的 Office 檔案,您可以選擇在您建立一份整備報表時掃描所有的 Office 文件。這將掃描所有的 Office 檔案,即便這些檔案並不包含巨集。由於一次需要掃描多個檔案,因此建立報表將耗費更長的時間。
如何將掃描雲端架構檔案
預設情況下,整備報告建立者無法掃描儲存在 SharePoint 文件庫、OneDrive 或一些其他類型的雲端儲存位置的檔案。如果您嘗試掃描其中一個檔案,檔案會在報告中顯示為 「 雲端式 」。
其中一項可行的因應措施是掃描這些雲端架構檔案在使用者電腦上的本機快取。如果檔案只儲存在雲端位置,您可以建立一個與 OneDrive 或 SharePoint 共用位置相互對應的網路磁碟機。然後,您就可以讓整備報告建立者掃描該磁碟機。但是,掃描此位置時,您必須把檔案下載到記憶體中,以便執行掃描。根據相關檔案的數量和大小,掃描相關檔案可能耗費大量時間,並用盡網路頻寬。
掃描 Office 文件以查看巨集簽章問題
為了增強 Office VBA 簽章專案簽署的安全性,Microsoft 提供了更安全的 VBA 專案簽章方案版本:V3 簽章。 我們建議組織將 V3 簽章套用至所有巨集,以消除竄改的風險。
您可以使用整備工具組尋找組織中應升級以使用 V3 簽章的現有已簽署 VBA 檔案。
若要尋找這些檔案,請從已提升權限的命令提示字元執行 Readiness Report Creator,並使用 sigscan 選項。 下列範例命令列會掃描 vba_files 資料夾中的檔案,並且將在 vba_results 資料夾中建立 JSON 檔案,並包含掃描結果。
ReadinessReportCreator.exe -sigscan -p C:\vba_files -r -output C:\vba_results
若要在 Excel 中檢視結果,請執行整備工具組,在 [建立整備報告] 頁面上,選取 [先前已一起儲存於本機資料夾或網路共用中的整備報告]。 然後,在命令列中指定使用 sigscan 所建立 JSON 檔案,並完成整備工具組精靈中的步驟。
注意
若要使用 sigscan,您必須至少使用 2021 年 3 月 19 日發行之整備工具組的版本 1.2.21067。
有關詳細資訊,包括如何將這些檔案升級為使用 V3 簽章,請參閱將已簽署的 Office VBA 巨集專案升級至 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 增益集。對於我們看到在 Microsoft 365 應用程式中執行的 COM 增益集,也會提供整備資訊。
增益集類型 | Office 應用程式 | 描述 |
---|---|---|
自動化 |
Excel |
支援 Excel 的自動化增益集是依據 COM 增益集所建置。可以從 Excel 工作表中的公式呼叫自動化增益集中的函數。 |
COM |
Excel、Outlook、PowerPoint 及 Word |
COM 增益集包含通常是以 C++ 和使用受控程式碼開發的 Visual Studio Tools for Office (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。 |
XLS RTD |
Excel |
XLS 即時資料 (RTD) 增益集是使用 RealTimeData 工作表函數來呼叫 Automation 伺服程式即時擷取資料的 Excel 工作表。 |
建立進階報告時,傳送給 Microsoft 的資訊範例
當您選擇建立進階報告時,某些資訊會傳送給 Microsoft。
下表提供傳送給 Microsoft,關於在掃描期間找到的 VBA 巨集的資訊清單,以及範例。
資料 | 描述 | 範例 |
---|---|---|
DevicesScanned |
已掃描的電腦數目。 |
DevicesScanned:23 |
UniqueUsers |
掃描中包含的使用者計數。 |
UniqueUsers:14 |
規則 |
特定規則套用到已掃描 VBA 巨集的次數。使用 GUID 以唯一識別規則。 |
48f05b1d-c8ad-4d0c-9453-1abdf007b2db:23 74db65ab-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 | 包含巨集須作修復以解除封鎖並升級至 Microsoft 365 應用程式的裝置數目。 | DevicesBlockedFromUpgrade: 1 |
DevicesWithMacrosWithIssues | 包含巨集出現相容性問題的裝置數目。 | DevicesWithMacrosWithIssues: 2 |
DevicesWhichRequireLimitedRemediation | 包含巨集檔案須作重大修復的裝置數目。 | DevicesWhichRequireLimitedRemediation: 12 |
DevicesWhichRequireMinimalValidation | 包含巨集檔案須作最小驗證的裝置數目。 | DevicesWhichRequireMinimalValidation: 12 |
DevicesWithMacrosWithoutIssues | 包含巨集但無任何相容性問題的裝置數目。 | DevicesWithMacrosWithoutIssues: 12 |
DevicesWithMacros | 包含巨集檔案的裝置數目。 | DevicesWithMacros: 12 |
DevicesSafeToUpgrade | 可升級至 Microsoft 365 應用程式的裝置數目。 | DevicesSafeToUpgrade: 12 |
DevicesWithOlderToolVersion | 使用舊版整備工具組的裝置數目。 | DevicesWithOlderToolVersion: 12 |
下表提供傳送給 Microsoft,關於在掃描期間找到的增益集的資訊清單,以及範例。
資料 | 範例 |
---|---|
增益集程式識別碼 |
UCAddin.LyncAddin.1 |
易記名稱 |
適用於 Microsoft Office 2016 的 Skype 會議增益集 (Outlook) |
描述 |
適用於 Microsoft Office 2016 的 Skype 會議增益集 |
檔案名稱 |
UCADDIN.DLL |
增益集 CLSID |
{A6A2383F-AD50-4D52-8110-3508275E77F7} |
提供者 |
Microsoft Corporation |
檔案戳記 |
1499940832 |
檔案版本 |
16.0.8326.2044 |
Office 應用程式 |
Outlook |
裝置數量 |
35 |
變更巨集設定,以檢視整備報告中的資訊
整備報告建立工具建立的報告會使用巨集和主動式內容,以在報告中顯示資訊。因此,若要在報告中查看 VBA 巨集相容性和增益集整備資訊,您必須在 Excel 中允許巨集和主動式內容。如果未在 Excel 中啟用巨集和主動式內容,您會在開啟報告時,於 [概觀] 工作表上看到 [開始使用] 訊息。該頁面上有如何啟用巨集和主動式內容的指示。這與在訊息列中按一下 [啟用內容] 一樣簡單。
在某些情況下,您可能不會看到訊息列和 [啟用內容] 選項。這種情形最有可能發生,因為 Excel 是設定為停用所有巨集且沒有通知。您可以藉由移至 [檔案] > [選項] > [信任中心] > [信任中心設定…] > [巨集設定] 來檢查此設定。在 [信任中心] 對話方塊中,您可以將設定變更為 [停用所有巨集並且通知]。在您這麼做之後,選擇 [確定] 以儲存變更並且關閉 [信任中心] 對話方塊,然後選擇 [確定] 以關閉 [Excel 選項] 對話方塊,然後關閉報告檔案。當您再次開啟報告檔案時,您應該會看到訊息列和 [啟用內容] 選項。
如果 [信任中心] 對話方塊中的巨集設定選項呈現灰色,則是系統管理員已經使用群組原則進行設定,且設定無法手動變更。在這種情況下,最簡單的解決方案是在與執行 Excel 巨集設定不同的電腦上開啟報告檔案,讓您藉由選取訊息列中的 [啟用內容] 選項來啟用巨集。
如需巨集設定選項的詳細資訊,請參閱在 Office 檔案中啟用或停用巨集。
針對分類為「未知」或「資料不足」的增益集所採取的可能步驟
如果增益集分類為「未知」或「資料不足」,則表示 Microsoft 尚未有與增益集相關的足夠資訊可以提供整備狀態。如果這是組織的商務關鍵性增益集,您可以執行下列動作:
請與開發此增益集的軟體提供者聯繫,確認此增益集是否支援 Microsoft 365 應用程式。
請透過 ReadyForOffice@microsoft.com 與我們連絡。我們會竭盡所能將增益集的整備狀態新增至我們的資料庫。請盡可能提供增益集的相關資訊,包括但不限於下列項目:
易記名稱
檔案版本
軟體提供者
下載連結,或有關如何下載及安裝增益集的任何詳細資料。
其他詳細資料,例如增益集的類型、增益集與哪個 Office 應用程式搭配使用、程式識別碼或 CLSID。
傳送給 Microsoft 的錯誤報告資訊
如果顯示整備報告時發生問題,您會收到訊息,詢問您是否想要傳送錯誤報告給 Microsoft。例如,如果在報告中建立圖表時或查詢收集的資料時發生問題。
藉由傳送錯誤報告給 Microsoft,您可以協助我們改善整備工具組。傳送給 Microsoft 的錯誤報告不會包含任何可識別個人的資訊。下表提供傳送給 Microsoft 的錯誤報告中包含哪些資訊的清單。
傳送的資料 | 描述 |
---|---|
模組 | 發生錯誤的 VBA 模組。 |
子/函數名稱 | 發生錯誤的子程序或函數的名稱。 |
行識別碼 | 最後成功執行的程式碼行開頭的識別碼。 |
錯誤訊息 | 使用者訊息通常會依據錯誤輸出。可能會針對某些錯誤當地語系化。 |
錯誤編號 | 識別錯誤的編號。 |
來源名稱 | 引發錯誤的物件名稱。這不是變數名稱。 |
工具版本 | 所使用的整備工具組版本。 |
報告 GUID | 針對每個報告產生的 GUID 有助於篩選出重複的錯誤。 |
工作階段識別碼 | 當建立報告來讓它與整備工具組所記錄的任何錯誤相互關聯時的工作階段識別碼。 |
Excel 版本 | 用來檢視整備報告的 Excel 版本。 |