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

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

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

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

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

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

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

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

使用 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.35.20 Python/3.11.6 Windows/10 botocore/1.18.6

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

解除安裝第 1 AWS CLI 版

若要使用下列解除安裝說明，您必須搭配 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 SDKs無法存取這些資料夾。

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

    $ rmdir %UserProfile%\.aws

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

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

先決條件

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

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

  1. 若要安裝第 1 AWS CLI 版，請使用 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 已正確安裝。如果沒有回應，請參閱 將第 1 AWS CLI 版可執行檔新增至命令列路徑 一節。

    C:\> aws --version
aws-cli/1.35.20 Python/3.11.6 Windows/10 botocore/1.18.6

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

  1. 如果您使用 安裝 第 1 AWS CLI 版pip，您也必須使用 解除安裝 pip。

    C:\> pip uninstall awscli

    如果您使用的是 Python 2 或 3 版，則可能需要使用 pip2 或 pip3 命令。使用 aws --version命令來判斷與您已安裝第 1 版相關聯的 Python AWS CLI 版本。

    C:\> pip3 uninstall awscli

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

  2. （選用） 移除 .aws 資料夾中的共用 AWS SDK 和 AWS CLI 設定資訊。

    警告

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

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

    $ rmdir %UserProfile%\.aws

將第 1 AWS CLI 版可執行檔新增至命令列路徑

使用 安裝 AWS CLI 版本 1 之後pip，請將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。