**本文件 AWS CLI 僅適用於 第 1 版。**
我們已宣布即將end-of-support。 AWS CLI 我們建議您遷移至 第 2 AWS CLI 版。如需日期、其他詳細資訊和如何遷移的資訊，請參閱 [公告](https://aws.amazon.com/blogs/developer/cli-v1-maintenance-mode-announcement/)。如需 第 2 版的相關文件 AWS CLI，請參閱 第 [2 版使用者指南](https://docs.aws.amazon.com/cli/latest/userguide/)。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 在 Windows 上安裝、更新和解除安裝第 1 AWS CLI 版
您可以使用獨立的安裝程式 （建議AWS CLI) 或 (Python 套件管理員）`pip`，在 Windows 上安裝 AWS Command Line Interface () 版本 1。
輸入命令時，請不要包含提示符號 (`C:\>`)。這些內容包括在程式清單中，用於區分您從 AWS CLI傳回的輸出中輸入的命令。本指南的其餘部分會使用通用提示符號 (`$`)，除非使用的是 Windows 專用命令。
**Topics**
+ [使用 MSI 安裝程式安裝、更新和解除安裝第 1 AWS CLI 版](#msi-on-windows)
+ [在 Windows 上使用 Python 和 pip 安裝、更新和解除安裝 AWS CLI 版本 1](#awscli-install-windows-pip)
+ [將 AWS CLI 版本 1 可執行檔新增至命令列路徑](#awscli-install-windows-path)
+ [針對 AWS CLI 安裝和解除安裝錯誤進行故障診斷](#awscli-install-windows-tshoot)
## 使用 MSI 安裝程式安裝、更新和解除安裝第 1 AWS CLI 版
Windows XP 或更新版本支援 第 1 AWS CLI 版。對於 Windows 使用者，MSI 安裝套件提供熟悉且方便的方式安裝第 1 AWS CLI 版，而無需安裝任何其他先決條件。
### 使用 MSI 安裝程式安裝和更新 AWS CLI 版本 1
請查看 [GitHub 上的 Releases 頁面](https://github.com/aws/aws-cli/releases)，以了解最新版本何時發佈。當發佈更新時，您必須重複安裝過程以獲取 AWS CLI 第 1 版的最新版本。
1. 下載合適的 MSI 安裝程式：
+ AWS CLI 適用於 Windows 的 MSI 安裝程式 (64 位元）：https：//[https://s3.amazonaws.com/aws-cli/AWSCLI64PY3.msi](https://s3.amazonaws.com/aws-cli/AWSCLI64PY3.msi)
+ AWS CLI 適用於 Windows 的 MSI 安裝程式 (32 位元）：https：//[https://s3.amazonaws.com/aws-cli/AWSCLI32PY3.msi](https://s3.amazonaws.com/aws-cli/AWSCLI32PY3.msi)
+ AWS CLI Windows 的合併設定檔案：[https：//https://s3.amazonaws.com/aws-cli/AWSCLISetup.exe](https://s3.amazonaws.com/aws-cli/AWSCLISetup.exe) （包含 32 位元和 64 位元 MSI 安裝程式，並自動安裝正確的版本）
1. 執行下載的 MSI 安裝程式或設定檔案。
1. 遵循螢幕說明。根據預設，第 1 AWS CLI 版會安裝到 `C:\Program Files\Amazon\AWSCLI`(64 位元版本） 或 `C:\Program Files (x86)\Amazon\AWSCLI`(32 位元版本）。
1. 若要確認安裝，請在命令提示字元使用 `aws --version` 命令 (您可以開啟**開始**功能表，並搜尋 `cmd` 來啟動命令提示字元)。
```
C:\> aws --version
aws-cli/1.40.41 Python/3.11.6 Windows/10 botocore/1.18.6
```
如果 Windows 找不到程式，您可能需要關閉命令提示字元再重新開啟，以重新整理路徑，或手動[將安裝目錄新增到 PATH](#awscli-install-windows-path) 環境變數。
### 解除安裝第 1 AWS CLI 版
若要使用下列解除安裝說明，您必須搭配 MSI 安裝程式或設定檔案來安裝 AWS CLI 第 1 版。
1. 請執行下列其中一個動作來開啟**程式和功能**：
+ 開啟**控制台**，然後選擇**程式和功能**。
+ 開啟命令提示字元並執行下列命令。
```
C:\> appwiz.cpl
```
1. 選擇名為 **AWS Command Line Interface** 的項目，然後選擇**解除安裝**以啟動解除安裝程式。
1. 確認您要解除安裝 AWS CLI。
1. **（選用）** 移除 `.aws` 資料夾中的共用 AWS SDK 和 AWS CLI 設定資訊。
**警告**
這些組態和憑據設定在所有 AWS 開發套件和 AWS CLI之間共用。如果您移除此資料夾，則系統上仍存在的任何 AWS SDKs無法存取這些資料夾。
`.aws` 資料夾的預設位置在平台之間各不相同，預設情況下，資料夾位於 *%UserProfile%\$1.aws*。
```
$ rmdir %UserProfile%\.aws
```
## 在 Windows 上使用 Python 和 pip 安裝、更新和解除安裝 AWS CLI 版本 1
Python 軟體基金會為 Windows 提供包含 `pip` 的安裝程式。
### 先決條件
您必須安裝 Python 3.8 版或更新版本。如需安裝說明，請參閱 Python《入門指南》**中的[下載 Python](https://wiki.python.org/moin/BeginnersGuide/Download)。
### 使用 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
```
1. 確認 AWS CLI 版本 1 已正確安裝。如果沒有回應，請參閱 [將 AWS CLI 版本 1 可執行檔新增至命令列路徑](#awscli-install-windows-path) 一節。
```
C:\> aws --version
aws-cli/1.40.41 Python/3.11.6 Windows/10 botocore/1.18.6
```
### 使用 pip 解除安裝 AWS CLI 版本 1
1. 如果您使用 安裝 AWS CLI 版本 1`pip`，您也必須使用 解除安裝 `pip`。
```
C:\> pip uninstall awscli
```
如果您使用的是 Python 2 或 3 版，則可能需要使用 `pip2` 或 `pip3` 命令。使用 `aws --version`命令來判斷與您已安裝第 1 版相關聯的 Python AWS CLI 版本。
```
C:\> pip3 uninstall awscli
```
您可能需要重新啟動命令提示字元視窗或電腦，才能移除所有檔案。
1. **（選用）** 移除 `.aws` 資料夾中的共用 AWS SDK 和 AWS CLI 設定資訊。
**警告**
這些組態和憑據設定在所有 AWS 開發套件和 AWS CLI之間共用。如果您移除此資料夾，則系統上仍存在的任何 AWS SDKs無法存取這些資料夾。
`.aws` 資料夾的預設位置在平台之間各不相同，預設情況下，資料夾位於 *%UserProfile%\$1.aws*。
```
$ rmdir %UserProfile%\.aws
```
## 將 AWS CLI 版本 1 可執行檔新增至命令列路徑
使用 安裝 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
...
```
------
1. 按下 Windows 鍵並輸入 **environment variables**。
1. 選擇 **Edit environment variables for your account (編輯您帳戶的環境變數)**。
1. 選擇 **PATH**，然後選擇 **Edit (編輯)**。
1. 將您找到的路徑加入**變數值**欄位中，例如 ***C:\$1Program Files\$1Amazon\$1AWSCLI\$1bin\$1aws.exe***。
1. 選擇 **OK** (確定) 兩次以套用新的設定。
1. 關閉任何正在執行的命令提示，並重新開啟命令提示字元視窗。
## 針對 AWS CLI 安裝和解除安裝錯誤進行故障診斷
如果您在安裝或解除安裝 之後遇到問題 AWS CLI，請參閱 [故障診斷 的錯誤 AWS CLI](cli-chap-troubleshooting.md) 以取得故障診斷步驟。如需最相關的故障診斷步驟，請參閱 [命令未找到錯誤](cli-chap-troubleshooting.md#tshoot-install-not-found)、[「`aws --version`」命令傳回的版本與您安裝的版本不同](cli-chap-troubleshooting.md#tshoot-install-wrong-version) 和 [解除安裝 後，「`aws --version`」命令會傳回版本 AWS CLI](cli-chap-troubleshooting.md#tshoot-uninstall-1)。