Microsoft 支援及修復小幫手的命令列版本

Microsoft 支援及修復小幫手的命令列版本 (SaRA) 是自包含的,而且可腳本化 (會在命令列或 PowerShell 腳本) 中執行。 此版本是企業適用于特定用戶端問題的診斷工具。 在系統管理員必須在組織中的電腦上遠端執行診斷工具時,這是很有用的情形。

下載並執行 SaRA 的命令列版本

  1. 使用下列連結下載 SaRA:https://aka.ms/SaRA_CommandLineVersionFiles

  2. 在已下載的檔案中,將 完成 的資料夾中的檔案解壓縮至您可以從其上執行 SaRA 的使用者電腦存取的資料夾。

  3. 在使用者的電腦上,選取 [ 開始]、[輸入], cmd 然後按 Enter 開啟 [命令提示字元] 視窗。

    附注: 請參閱「支援的參數」一節中的表格,以判斷是否需要提升許可權的命令提示字元視窗才能為使用者的案例執行 SaRA。

  4. 在 [命令提示字元] 視窗中,流覽至您從步驟2解壓縮檔案的資料夾。

  5. 使用「支援的參數」一節中討論的一或多個參數,來執行 SaRA 的命令列版本。

    重要

    將定期發行 SaRA 的命令列版本更新。 為了確保您使用的是最新版本的功能和最高的穩定性,每個應用程式組建都會在 SaRAcmd.exe 所列出的 日期之後停止90天的工作。 使用步驟1中提供的連結下載最新版本。

支援的參數

下列參數可用於控制 SaRAcmd.exe。

附注: 參數不區分大小寫。

  1. -S <scenarioname>

    使用 -S 參數來指定您想要執行的案例。 無法自行執行參數。 必須後接 -AcceptEula 。 例如,若要執行可移除目前安裝的 Office 版本的案例,請輸入 -S OfficeScrubScenario -AcceptEula ,然後按 enter。

    目前,下列案例是透過命令列來支援的。

    Scenarioname 完整 (UI) 版本中的案例進入點 SaRA 需要提升許可權的命令提示字元視窗
    ExpertExperienceAdminTask Advanced Diagnostics \ Outlook
    OfficeScrubScenario Office 我已安裝 Office,但在卸載時有問題
    TeamsAddinScenario Teams [未顯示 Teams 會議] 選項,或 Teams 會議增益集未載入于 Outlook

    附注: 若要開啟提升許可權的命令提示字元視窗,請選取 [ 開始],輸入 cmd ,以滑鼠右鍵按一下結果中的 [ 命令提示 字元],然後選取 [ 以管理員身分執行]。

  2. -CloseOutlook

    -CloseOutlook需要參數才能執行 TeamsAddinScenario。
    附注:如果執行 Outlook,此參數會關閉 Outlook。

  3. -AcceptEula

    在執行案例之前,必須先接受「使用者授權合約 (EULA) 。 如果您使用的是 -AcceptEULA ,您也必須使用 -S <scenarioname> 來指定您要執行的案例。 例如,若要卸載 Office,請從提升許可權的命令提示字元視窗中執行下列命令:

    SaRAcmd.exe -S OfficeScrubScenario -AcceptEula
    

    如果您想要執行 Outlook 的高級診斷案例,請執行下列命令:

    SaRAcmd.exe -S ExpertExperienceAdminTask -AcceptEula
    
  4. -DisplayEULA

    使用 -DisplayEULA 參數來顯示 EULA。 若要將 EULA 文字儲存至檔案,請執行類似下列範例的命令:

    SaRAcmd.exe -DisplayEULA > c:\temp\SaRAEula.txt
    
  5. -Help

    -Help參數會顯示線上內容的連結,以取得其他資訊。 如果您 -Help 搭配使用其他參數,則 -Help 會覆寫除開關以外的所有其他參數 -?

  6. -?

    使用 -? 參數,顯示所有可用於 SaRAcmd.exe 的參數的功能。 如果您 -? 搭配使用其他參數, -? 將會覆寫其他參數。

命令列案例所解決的條件

當您使用 SaRA 的命令列版本執行案例時,不會收到任何提示。 這是完整版 SaRA 的不同體驗。 下表說明 SaRA 所用命令列版本的動作,以及該工具針對案例中的每個條件所顯示的輸出。

  • ExpertExperienceAdminTask

    條件 命令列版本採取的動作 命令提示字元視窗中的輸出
    Outlook 未執行 執行 Outlook 的離線掃描 01: 已執行離線掃描,因為 Outlook 未執行或以系統管理員) 的身分 (執行。 請 <filename> 參閱 %localappdata%\saralogs\UploadLogs
    Outlook 正在執行中 執行 Outlook 的完整掃描 02: 已執行完整掃描。 請 <filename> 參閱 %localappdata%\saralogs\UploadLogs
    偵測到一個以上的 Outlook 版本 執行最新版本的 Outlook 掃描 (視情況而定,此輸出可能是 01020405)
    Outlook,且命令提示字元視窗會同時提升 執行 Outlook 的完整掃描 02: 已執行完整掃描。 請 <filename> 參閱 %localappdata%\saralogs\UploadLogs
    Outlook 會以提升的狀態執行;不會提升 SaRA 命令提示字元視窗 執行 Outlook 的離線掃描 01: 已執行離線掃描,因為 Outlook 未執行或以系統管理員) 的身分 (執行。 請 <filename> 參閱 %localappdata%\saralogs\UploadLogs
    Outlook 未以提升的狀態執行;SaRA 命令提示字元視窗會提升 04: Outlook 未以提升的狀態執行。 請勿使用提升許可權的命令提示字元。
    因任何原因而無法執行掃描 () ;例如:
    1. 未安裝 Outlook
    2. 只偵測到一個 Outlook 版本,且該版本的版本低於2007
    3. 掃描期間發生例外狀況
    已啟動掃描,但尚未完成 05: 執行 Outlook 的掃描時發生錯誤。 如果您退出 Outlook 並重新執行此案例,您可能能夠執行離線掃描。 您也可以嘗試使用完整的 SaRA 版本。
  • OfficeScrubScenario

    條件 命令列版本採取的動作 命令提示字元視窗中顯示的輸出
    Office 移除成功 00: 已成功完成此案例。

    附注: 建議您重新開機電腦,以完成餘下的任何清理工作。
    Office 程式 .exe 執行中找到檔案:

    lync、winword、excel、msaccess、mstore、infopath、setlang、msouc、ois、onenote、outlook、powerpnt、mspub、groove、visio、winproj、graph、團隊
    退出案例 06:正在執行 Office 程式。 請關閉所有開啟的 Office 程式,然後重新執行此案例。
    找不到 Office 產品 退出案例 07: 找不到任何已安裝的 Office 版本。 請使用完整的 SaRA 版本。
    找到多個 Office 產品 退出案例 08: 找到多個 Office 版本。 請使用完整的 SaRA 版本。
    移除 Office 失敗 退出案例 09: 無法移除 Office。 請使用完整的 SaRA 版本。
    不會提升 SaRA 退出案例 10: 此案例必須執行 SaRA 的高要求。 請使用提升許可權的命令提示。
  • TeamsAddinScenario

    條件 命令列版本採取的動作 命令提示字元視窗中顯示的輸出
    掃描順利完成 00: 已成功完成案例。 請退出,然後重新開機 Outlook。
    使用者不包含 -CloseOutlook 參數 退出案例 01: 此案例需要-CloseOutlook 參數。 請注意,如果 Outlook 執行中,-CloseOutlook 參數會關閉 Outlook。 如需其他資訊,請造訪 https://aka.ms/SaRA_CommandLineVersion
    使用者不包含 -AcceptEula 參數 退出案例 01: 請提供 AcceptEula 以繼續此案例。 如需其他資訊,請造訪 https://aka.ms/SaRA_CommandLineVersion
    未安裝 Teams 退出案例 20: 找不到已安裝的 Teams 版本。 請參閱 https://support.office.com/article/how-do-i-get-access-to-microsoft-teams-fc7f1634-abd3-4f26-a597-9df16e4ca65b
    未安裝 Outlook 2013 或更新版本 退出案例 21: 找不到已安裝的 Outlook 2013 或更新版本。 看到 https://go.microsoft.com/fwlink/?linkid=2129032
    Windows 7 使用者在安裝 Windows 中未安裝通用 C 運行時間的更新 退出案例 22: 不符合先決條件。 必須安裝從 KB2999226 更新。 看到 https://go.microsoft.com/fwlink/?linkid=2129032
    偵測到登錄問題:

    LoadBehavior 列在 key 或 TeamsAddin 底下的<>3 或增益集 DisabledItems 。連線機碼底下 <> 1 DoNotDisableAddinList
    執行 [登錄復原] 動作,然後結束案例。 23: 登錄已更新,以處理遺失或不正確的值。 請退出,然後重新開機 Outlook。

    17: 執行此案例時發生錯誤。 您也可以嘗試使用完整的 SaRA 版本。
    未偵測到上述任何情況 請執行重新註冊的 dll 復原動作,然後結束此案例。 24: 已重新註冊 Microsoft.Teams.AddinLoader.dll。 請退出,然後重新開機 Teams。 然後,請退出並重新啟動 Outlook。
    因任何原因而無法完成案例 () 退出案例 17: 執行此案例時發生錯誤。 您也可以嘗試使用完整的 SaRA 版本。

SaRA 命令列版本歷程記錄

在整個一年中,您可以透過本文開頭提供的下載連結取得 SaRA 的新組建。 因為每個組建都會在90天后停止運作,所以建議您以最新版本的檔案來取代更新 SaRA。

下表提供指定日期所提供的 SaRA 版本。

發行日期 SaRACmd.exe 版本
2021 年 5 月 26 日 17.00.6665.000

如需完整版 SaRA 的詳細資訊,請參閱關於 Microsoft 支援及修復小幫手