在 Windows 上安裝、更新和解除安裝 AWS CLI 第 1 版 - AWS Command Line Interface
使用 MSI 安裝程式安裝、更新和解除安裝使用 Python 和 pip 安裝、更新和解除安裝新增 AWS CLI 可執行檔到您的命令列路徑故障診斷 AWS CLI 安裝和解除安裝錯誤

本文件僅適用於 AWS CLI 的第 1 版。如需 AWS CLI 第 2 版的相關文件，請參閱第 2 版使用者指南。

在 Windows 上安裝、更新和解除安裝 AWS CLI 第 1 版

您可以使用獨立安裝程式 (建議) 或 pip (Python 套件管理工具)，在 Windows 上安裝 AWS Command Line Interface (AWS CLI) 版本 1。

輸入命令時，請不要包含提示符號 (C:\>)。這些內容包括在程式清單中，用於區分您從 AWS CLI 傳回的輸出中輸入的命令。本指南的其餘部分會使用通用提示符號 ($)，除非使用的是 Windows 專用命令。

使用 MSI 安裝程式安裝、更新和解除安裝 AWS CLI 第 1 版

AWS CLI 第 1 版支援 Windows XP 或更新版本。對於 Windows 使用者，MSI 安裝套件提供了一種熟悉且方便的方法來安裝 AWS CLI 第 1 版，無需任何其他安裝先決條件。

使用 MSI 安裝程式安裝和更新 AWS CLI 第 1 版

請查看 GitHub 上的 Releases 頁面，以了解最新版本何時發佈。當發佈更新時，您必須重複安裝過程以獲取 AWS CLI 第 1 版的最新版本。

  1. 下載合適的 MSI 安裝程式：

  2. 執行下載的 MSI 安裝程式或設定檔案。

  3. 遵循螢幕說明。在預設情況下，AWS CLI 第 1 版將安裝到 C:\Program Files\Amazon\AWSCLI (64 位元版本) 或 C:\Program Files (x86)\Amazon\AWSCLI (32 位元版本)。

  4. 若要確認安裝，請在命令提示字元使用 aws --version 命令 (您可以開啟開始功能表，並搜尋 cmd 來啟動命令提示字元)。

    C:\> aws --version
aws-cli/1.27.69 Python/3.11.2 Windows/10 botocore/1.13

    如果 Windows 找不到程式，您可能需要關閉命令提示字元再重新開啟，以重新整理路徑，或手動將安裝目錄新增到 PATH 環境變數。

解除安裝 AWS CLI 第 1 版

若要使用下列解除安裝說明，您必須搭配 MSI 安裝程式或設定檔案來安裝 AWS CLI 第 1 版。

  1. 請執行下列其中一個動作來開啟程式和功能：

    • 開啟控制台，然後選擇程式和功能。

    • 開啟命令提示字元並執行下列命令。

      C:\> appwiz.cpl

  2. 選擇名為 AWS Command Line Interface 的項目，然後選擇解除安裝以啟動解除安裝程式。

  3. 確認您要解除安裝 AWS CLI。

  4. (選用) 移除 .aws 資料夾中的共享 AWS SDK 和 AWS CLI 設定資訊。

    警告

    這些組態和憑據設定在所有 AWS 開發套件和 AWS CLI 之間共用。如果您移除此資料夾，則您的系統中仍然存在的任何 AWS SDK 將無法存取它們。

    .aws 資料夾的預設位置在平台之間各不相同，預設情況下，資料夾位於 %UserProfile%\.aws。

    $ rmdir %UserProfile%\.aws

在 Windows 上使用 Python 和 pip 安裝、更新和解除安裝 AWS CLI 第 1 版

Python 軟體基金會為 Windows 提供包含 pip 的安裝程式。

先決條件

您必須安裝 Python 3.7 版或更新版本。如需安裝說明，請參閱 Python《入門指南》中的下載 Python。

警告

Python 軟體基金會已於 2020 年 1 月 1 日棄用 Python 2.7。從 AWS CLI 1.20.0 版開始，則至少需要 Python 3.6 版。

若要將舊版 Python 與 AWS CLI 第 1 版搭配使用，您需要安裝舊版的 AWS CLI 第 1 版。若要檢視 AWS CLI 第 1 版 Python 版本支援對照表，請參閱 Python 版本要求。

使用 pip 安裝和更新 AWS CLI 第 1 版

  1. 若要安裝 AWS CLI 第 1 版，請使用 pip3 命令 (如果您使用 Python 第 3 版或更新版本) 或 pip 命令。

    若為最新版本的 AWS CLI，請使用下列命令區塊：

    C:\> pip3 install awscli --upgrade --user

    若為特定版本的 AWS CLI，請在檔案名稱中附加小於符號 < 和版本號碼。在這個範例中，版本 1.16.312 的檔案名稱為 <1.16.312，因此使用以下命令：

    C:\> pip3 install awscli<1.16.312 --upgrade --user

  2. 確認已正確安裝 AWS CLI 第 1 版。如果沒有回應，請參閱 新增 AWS CLI 第 1 版可執行檔到您的命令列路徑 一節。

    C:\> aws --version
aws-cli/1.27.69 Python/3.11.2 Windows/10 botocore/1.13

使用 pip 解除安裝 AWS CLI 第 1 版

  1. 如果您使用 pip 安裝了 AWS CLI 第 1 版，您也必須使用 pip 解除安裝。如果您使用 Python 第 3 版或更新版本，建議您使用 pip3 命令。

    C:\> pip3 uninstall awscli

    您可能需要重新啟動命令提示字元視窗或電腦，才能移除所有檔案。

  2. (選用) 移除 .aws 資料夾中的共享 AWS 開發套件和 AWS CLI 設定資訊。

    警告

    這些組態和憑據設定在所有 AWS 開發套件和 AWS CLI 之間共用。如果您移除此資料夾，則您的系統中仍然存在的任何 AWS SDK 將無法存取它們。

    .aws 資料夾的預設位置在平台之間各不相同，預設情況下，資料夾位於 %UserProfile%\.aws。

    $ rmdir %UserProfile%\.aws

新增 AWS CLI 第 1 版可執行檔到您的命令列路徑

使用 pip 安裝 AWS CLI 第 1 版後，新增 aws 程式至您作業系統的 PATH 環境變數。使用 MSI 安裝時，這應該會自動發生。但是，如果在安裝之後沒有執行 aws 命令，您可能需要手動設定它。

  1. 使用 where 命令尋找 aws 檔案位置。依預設，where 命令會顯示在系統的 PATH 中找到指定程式的位置。

    C:\> where aws

    顯示的路徑取決於您的平台以及您用來安裝 AWS CLI 的方法。包括版本號碼的資料夾名稱可能有所不同。上述範例會反映使用 Python 3.7 版的情形。視需要將版本替換為您正在使用的版本號碼。典型路徑包括下列各項：

    • Python 3 和 pip3 – C:\Program Files\Python37\Scripts\

    • Python 3 和 pip3 – 舊版 Windows 上的使用者選項 – %USERPROFILE%\AppData\Local\Programs\Python\Python37\Scripts

    • Python 3 和 pip3 – Windows 10 上的使用者選項 – %USERPROFILE%\AppData\Roaming\Python\Python37\Scripts

    • MSI 安裝程式 (64 位元) – C:\Program Files\Amazon\AWSCLI\bin

    • MSI 安裝程式 (32 位元) – C:\Program Files (x86)\Amazon\AWSCLI\bin

    根據是否傳回檔案路徑使用下列步驟。

    A file path is returned
    C:\> where aws
C:\Program Files\Amazon\AWSCLI\bin\aws.exe

    您可以執行下列命令，找到 aws 程式的安裝位置。

    C:\> where c:\ aws
C:\Program Files\Python37\Scripts\aws
    A file path is NOT returned

    如果 where 命令傳回下列錯誤，則其不在系統 PATH 中，而您不能只輸入其名稱來執行。

    C:\> where c:\ aws
INFO: Could not find files for the given pattern(s).

    此時請以 /R path 參數執行 where 命令，要求其搜尋所有資料夾，然後手動加入路徑。使用命令列或檔案總管來探索它在您電腦上的安裝位置。

    C:\> where /R c:\ aws
c:\Program Files\Amazon\AWSCLI\bin\aws.exe
c:\Program Files\Amazon\AWSCLI\bincompat\aws.cmd
c:\Program Files\Amazon\AWSCLI\runtime\Scripts\aws
c:\Program Files\Amazon\AWSCLI\runtime\Scripts\aws.cmd
...

  2. 按下 Windows 鍵並輸入 environment variables。

  3. 選擇 Edit environment variables for your account (編輯您帳戶的環境變數)。

  4. 選擇 PATH，然後選擇 Edit (編輯)。

  5. 將您找到的路徑加入變數值欄位中，例如 C:\Program Files\Amazon\AWSCLI\bin\aws.exe。

  6. 選擇 OK (確定) 兩次以套用新的設定。

  7. 關閉任何正在執行的命令提示，並重新開啟命令提示字元視窗。

故障診斷 AWS CLI 安裝和解除安裝錯誤

如果在安裝或解除安裝 AWS CLI 時發生錯誤，請參閱 故障診斷 AWS CLI 錯誤 以瞭解故障診斷步驟。如需最相關的故障診斷步驟，請參閱 命令未找到錯誤、「aws --version」命令傳回的版本與您安裝的版本不同 和 「aws --version」命令在解除安裝 AWS CLI 後傳回一個版本。