本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 針對 的安裝問題進行故障診斷 AWS Toolkit for Visual Studio
<a name="setup-troubleshoot"></a>

下列資訊已知可在設定 時解決常見的安裝問題 AWS Toolkit for Visual Studio。

如果您在安裝 時發生錯誤， AWS Toolkit for Visual Studio 或不確定安裝是否已完成，請檢閱下列各節中的資訊。

## Visual Studio 的管理員許可
<a name="setup-troubleshoot-admin"></a>

 AWS Toolkit for Visual Studio 擴充功能需要管理員許可，以確保可存取所有 AWS 服務和功能。

如果您有本機管理員許可，您的管理員許可可能不會直接延伸至您的 Visual Studio 執行個體。

若要在本機啟動具有管理員許可的 Visual Studio：

1. 從 Windows 找到 Visual Studio 應用程式啟動器 （圖示）。

1. 開啟 Visual Studio 圖示的內容選單 （按一下滑鼠右鍵） 以開啟內容選單。

1. 從內容功能表中選取以**管理員身分執行**。

若要從遠端啟動具有管理員許可的 Visual Studio：

1. 在 Windows 中，尋找您用來連線至 Visual Studio 遠端執行個體之應用程式的應用程式啟動器。

1. 開啟應用程式的內容選單 （按一下滑鼠右鍵） 以開啟內容選單。

1. 從內容功能表中選取以**管理員身分執行**。

**注意**  
無論您是在本機啟動程式，還是從遠端連線，Windows 可能會提示您確認管理登入資料。

## 取得安裝日誌
<a name="setup-troubleshoot-install-log"></a>

如果您已完成上述*管理員許可*區段中的步驟，並確認您正在執行或使用管理員許可連線至 Visual Studio，則取得安裝日誌檔案有助於診斷其他問題。

若要 AWS Toolkit for Visual Studio 從 `.vsix` 檔案手動安裝 並產生安裝日誌檔案，請完成下列步驟。

1. 在[AWS Toolkit for Visual Studio](https://aws.amazon.com/visualstudio/)登陸頁面中，遵循**下載**連結並儲存您要安裝的 AWS Toolkit for Visual Studio 版本`.vsix`檔案。

1. 從 Visual Studio 主功能表中，展開**工具**標頭，展開**命令列**子選單，然後選擇 **Visual Studio 開發人員命令提示**字元。

1. 從 **Visual Studio 開發人員命令提示**字元輸入下列格式的`vsixinstaller`命令：

   `vsixinstaller /logFile:[file path to log file] [file path to Toolkit installation file]`

1. 將 取代`[file path to log file]`為您要建立安裝日誌之目錄的檔案名稱和完整檔案路徑。`vsixinstaller` 命令的範例與指定的檔案路徑和檔案名稱類似如下：

   `vsixinstaller /logFile:C:\Users\Documents\install-log.txt [file path to AWSToolkitPackage.vsix]`

1. `[file path to Toolkit installation file]` 將 取代為 `AWSToolkitPackage.vsix` 所在目錄的完整檔案路徑。

   具有 Toolkit 安裝檔案完整檔案路徑的 `vsixinstaller`命令範例應類似下列：

   `vsixinstaller /logFile:[file path to log file] C:\Users\Downloads\AWSToolkitPackage.vsix`

1. 檢查您的檔案名稱和路徑是否正確，然後執行 `vsixinstaller`命令。

   完整`vsixinstaller`命令的範例如下所示：

   `vsixinstaller /logFile:C:\Users\Documents\install-log.txt C:\Users\Downloads\AWSToolkitPackage.vsix`

## 安裝不同的 Visual Studio 延伸模組
<a name="setup-troubleshoot-extensions"></a>

如果您已經取得安裝日誌檔案，但仍無法判斷安裝程序失敗的原因，請檢查您是否能夠安裝其他 Visual Studio 延伸模組。安裝不同的 Visual Studio 延伸模組可以為您的安裝問題提供額外的洞見。如果您無法安裝任何 Visual Studio 延伸模組，則可能需要對 Visual Studio 的問題進行疑難排解，而不是進行疑難排解 AWS Toolkit for Visual Studio。

## 聯絡支援
<a name="setup-troubleshoot-contact"></a>

如果您已檢閱本指南中包含的所有區段，並需要額外的資源或支援，則可以檢視過去的問題，或從 [AWS Toolkit for Visual Studio Github Issues](https://github.com/aws/aws-toolkit-visual-studio/issues/) 網站開啟新問題。

為了協助加速問題的解決方案：
+ 檢查過去和目前的問題，以查看其他人是否遇到類似的情況。
+ 記下您為了解決問題所採取的每個步驟的詳細記錄。
+ 儲存您從安裝 AWS Toolkit for Visual Studio 或其他擴充功能取得的任何日誌檔案。
+ 將 AWS Toolkit for Visual Studio 安裝日誌檔連接至新問題。