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

本文件僅適用於 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.22.23 Python/3.8.8 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 SDK 和 AWS CLI 之間共用。如果您移除此資料夾,則您的系統中仍然存在的任何 AWS SDK 將無法存取它們。

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

    $ rmdir %UserProfile%\.aws

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

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

先決條件

您必須安裝 Python 3.6 版或更新版本。如需安裝說明,請參閱 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.22.23 Python/3.8.8 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 SDK 和 AWS CLI 設定資訊。

    警告

    這些組態和憑據設定在所有 AWS SDK 和 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 和 pip3C:\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. 關閉任何正在執行的命令提示,並重新開啟命令提示字元視窗。