AWS CLI 安裝指示 AWS CLI 更新指示針對 AWS CLI 安裝和解除安裝錯誤進行故障診斷後續步驟

安裝或更新至最新版本的 AWS CLI

本主題說明如何在支援的作業系統上安裝或更新最新版本的 AWS Command Line Interface (AWS CLI)。如需最新版本的資訊 AWS CLI，請參閱 GitHub 上的AWS CLI 第 2 版變更日誌。

若要安裝過去版本的 AWS CLI，請參閱安裝 AWS CLI 第 2 版的過去版本。如需解除安裝說明，請參閱解除安裝第 2 AWS CLI 版。

重要

AWS CLI 第 1 版和第 2 版使用相同的aws命令名稱。如果您先前已安裝 AWS CLI 版本 1，請參閱第 2 AWS CLI 版的遷移指南。

AWS CLI 安裝指示

如需安裝說明，請根據您的作業系統展開相應的區段。

安裝需求

您必須能夠解壓縮或「解壓縮」下載的套件。如果您的作業系統沒有內建 unzip 命令，請使用對等的命令。
AWS CLI 使用 glibc、 groff和 less。依預設，這些會包含在 Linux 的大多數主要發行版中。
我們支援 AWS CLI 64 位元版本的最新 CentOS、Fedora、Ubuntu、Amazon Linux 1、Amazon Linux 2、Amazon Linux 2023 和 Linux ARM 發行版本。
由於 AWS 不會維護以外的第三方儲存庫snap，因此我們無法保證它們包含最新版本的 AWS CLI。

安裝 AWS CLI

警告

如果這是您第一次在 Amazon Linux 上更新，若要安裝最新版本的 AWS CLI，您必須使用以下命令解除安裝預先安裝的yum版本：


$ sudo yum remove awscli

AWS CLI 移除 yum 安裝之後，請遵循下列 Linux 安裝指示。

您可以使用下列 AWS CLI 其中一種方法來安裝：

安裝指令碼是安裝的建議方法 AWS CLI。若要更新 AWS CLI，請參閱 AWS CLI 更新指示。
命令列安裝程式是版本控制的好選項，因為您可以指定要安裝的版本。此選項不會自動更新；若要更新，請參閱 AWS CLI 更新指示。
正式支援的snap套件是保持最新版本的良好選項， AWS CLI 因為快照套件會自動重新整理。不支援選取的次要版本 AWS CLI ，因此，如果您的團隊需要鎖定版本，則不是最佳安裝方法。

Install script (recommended)

安裝指令碼會在一個步驟中下載、驗證和安裝適用於 Linux 的 AWS CLI 。它適用於 Linux x86 (64 位元）和 Linux ARM，預設會為目前使用者安裝。

若要安裝 AWS CLI，請執行下列命令。


$ curl -fsSL https://awscli.amazonaws.com/v2/install.sh | bash

注意

根據預設，指令碼會安裝至，$HOME/.local/share/aws-cli並在中建立符號連結$HOME/.local/bin。若要將安裝到不同的位置，請先設定 $XDG_DATA_HOME和 $XDG_BIN_HOME環境變數，再執行指令碼。

若要改為為所有使用者安裝（安裝至 /usr/local/aws-cli和 /usr/local/bin)，需要 sudo，請將 --system引數傳遞至指令碼。


$ curl -fsSL https://awscli.amazonaws.com/v2/install.sh | sudo bash -s -- --system

如需選項的完整清單，請使用執行指令碼--help。


$ curl -fsSL https://awscli.amazonaws.com/v2/install.sh | bash -s -- --help

若要更新 AWS CLI，請參閱 AWS CLI 更新指示。

Command line installer - Linux x86 (64-bit)

請依照這些步驟，從命令列在 Linux 上安裝 AWS CLI 。若要更新以這種方式建立的安裝，請參閱 AWS CLI 更新指示而非重複這些步驟。

以下是單一複製和貼上群組的快速安裝步驟，提供基本安裝。如需引導式指示，請參閱下列步驟。

注意

（選用） 下列命令區塊會下載並安裝， AWS CLI 而無需先驗證下載的完整性。若要驗證下載的完整性，請使用以下逐步說明。

若要安裝 AWS CLI，請執行以下命令。


$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install

引導式安裝步驟

使用下列其中一種方式下載安裝檔案：
- 使用 curl 命令 – -o 選項會指定已下載套件寫入的檔案名稱。下列範例命令的選項會使下載的檔案以本機時間 awscliv2.zip 寫入目前的目錄。
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
```
- 從 URL 下載 – 若要使用瀏覽器下載安裝程式，請使用下列 URL：https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip

(可選) 驗證所下載 zip 檔案的完整性

如果您選擇.zip在上述步驟中手動下載 AWS CLI 安裝程式套件，則可以使用 GnuPG工具，使用下列步驟來驗證簽章。

AWS CLI 安裝程式套件.zip檔案使用 PGP 簽章進行密碼編譯簽署。如果檔案有任何損壞或更改，此驗證會失敗，且您不應該繼續進行安裝。

使用您的套件管理工具下載並安裝 gpg 命令。如需有關 GnuPG 的詳細資訊，請參閱 GnuPG 網站。

若要建立公開金鑰檔案，請建立文字檔案，然後貼上下列文字。

以下公開金鑰詳細資訊僅供參考。


Key ID:           A6310ACC4672475C
Type:             RSA
Size:             4096/4096
Created:          2019-09-18
Expires:          2027-07-01
User ID:          AWS CLI Team <aws-cli@amazon.com>
Key fingerprint:  FB5D B77F D5C1 18B8 0511  ADA8 A631 0ACC 4672 475C

使用下列命令匯入 AWS CLI 公有金鑰，以您建立之公有金鑰的檔案名稱取代 public-key-file-name。


$ gpg --import public-key-file-name
gpg: /home/username/.gnupg/trustdb.gpg: trustdb created
gpg: key A6310ACC4672475C: public key "AWS CLI Team <aws-cli@amazon.com>" imported
gpg: Total number processed: 1
gpg:               imported: 1

下載您下載之套件的 AWS CLI 簽章檔案。它會有與其對應的 .zip 檔案具有相同的路徑和名稱，但具有副檔名 .sig。在下列範例中，我們將它作為名稱 awscliv2.sig 的檔案儲存在目前的資料夾。

對於最新版本的 AWS CLI，請使用下列命令區塊：
```
$ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip.sig
```

驗證簽章，並將下載的 .sig 和 .zip 檔案名稱以參數形式傳遞給 gpg 命令。


$ gpg --verify awscliv2.sig awscliv2.zip

輸出應看起來如下列內容。


gpg: Signature made Mon Nov  4 19:00:01 2019 PST
gpg:                using RSA key FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
gpg: Good signature from "AWS CLI Team <aws-cli@amazon.com>" [unknown]
gpg: WARNING: This key is not certified with a trusted signature!
gpg:          There is no indication that the signature belongs to the owner.
Primary key fingerprint: FB5D B77F D5C1 18B8 0511  ADA8 A631 0ACC 4672 475C

重要

輸出中的警告是預期的，並不表示有問題。這是因為您的個人 PGP 金鑰（如果您有）和 AWS CLI PGP 金鑰之間沒有信任鏈。如需詳細資訊，請參閱「信任網路」。

解壓縮安裝程式。如果您的 Linux 發行版沒有內建 unzip 命令，請使用類似命令解壓縮。下列範例命令會解壓縮套件，並在名為 aws 的目前目錄下建立目錄。
```
$ unzip awscliv2.zip
```
注意
從舊版更新時，unzip 命令會提示覆寫現有檔案。若要略過這些提示 (例如使用指令碼自動化)，對於 unzip 請使用 -u 更新標記。這個標記會視需要自動更新現有檔案和建立新檔案。
```
$ unzip -u awscliv2.zip
```
執行安裝程式。安裝命令會使用新解壓縮的 aws 目錄中名為 install 的檔案。依預設，檔案會全部安裝到 /usr/local/aws-cli，並在 /usr/local/bin 中建立符號連結。命令包括 sudo，以授予寫入權限給這些資料夾。
```
$ sudo ./aws/install
```
如果指定您已具有寫入權限的資料夾，則可以在不使用 sudo 的情況下進行安裝。使用下列 install 命令指示來指定安裝位置：
- 請確定您提供給 -i 和 -b 參數的路徑不包含任何包含空格字元或其他空格字元的磁碟區名稱或目錄名稱。如果有空格，則安裝會失敗。
- --install-dir 或 -i – 此選項指定要將所有檔案複製到的目錄。
  
  預設值為 /usr/local/aws-cli。
- --bin-dir 或 -b – 此選項會指定安裝目錄中的 aws 主程式以符號方式連結至指定路徑的檔案 aws。您必須具有指定目錄的寫入許可。建立路徑中已存在目錄的符號連結，可讓您不需將安裝目錄新增到使用者的 $PATH 變數。
  
  預設值為 /usr/local/bin。
```
$ ./aws/install -i /usr/local/aws-cli -b /usr/local/bin
```
注意
若要更新以此方式建立的安裝，請參閱 AWS CLI 更新指示。
請使用以下命令來確認安裝。
```
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 
```
如果找不到 aws 命令，您可能需要重新啟動終端機或遵循故障診斷的錯誤 AWS CLI 中的故障診斷。

Command line - Linux ARM

請依照這些步驟，從命令列在 Linux 上安裝 AWS CLI 。若要更新以這種方式建立的安裝，請參閱 AWS CLI 更新指示而非重複這些步驟。

以下是單一複製和貼上群組的快速安裝步驟，提供基本安裝。如需引導式指示，請參閱下列步驟。

注意

（選用） 下列命令區塊會下載並安裝， AWS CLI 而無需先驗證下載的完整性。若要驗證下載的完整性，請使用以下逐步說明。

若要安裝 AWS CLI，請執行下列命令。


$ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install

引導式安裝步驟

使用下列其中一種方式下載安裝檔案：
- 使用 curl 命令 – -o 選項會指定已下載套件寫入的檔案名稱。下列範例命令的選項會使下載的檔案以本機時間 awscliv2.zip 寫入目前的目錄。
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip" -o "awscliv2.zip"
```
- 從 URL 下載 – 若要使用瀏覽器下載安裝程式，請使用下列 URL：https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip

(可選) 驗證所下載 zip 檔案的完整性

如果您選擇.zip在上述步驟中手動下載 AWS CLI 安裝程式套件，則可以使用 GnuPG工具，使用下列步驟來驗證簽章。

AWS CLI 安裝程式套件.zip檔案使用 PGP 簽章進行密碼編譯簽署。如果檔案有任何損壞或更改，此驗證會失敗，且您不應該繼續進行安裝。

使用您的套件管理工具下載並安裝 gpg 命令。如需有關 GnuPG 的詳細資訊，請參閱 GnuPG 網站。

若要建立公開金鑰檔案，請建立文字檔案，然後貼上下列文字。

以下公開金鑰詳細資訊僅供參考。


Key ID:           A6310ACC4672475C
Type:             RSA
Size:             4096/4096
Created:          2019-09-18
Expires:          2027-07-01
User ID:          AWS CLI Team <aws-cli@amazon.com>
Key fingerprint:  FB5D B77F D5C1 18B8 0511  ADA8 A631 0ACC 4672 475C

使用下列命令匯入 AWS CLI 公有金鑰，以您建立之公有金鑰的檔案名稱取代 public-key-file-name。


$ gpg --import public-key-file-name
gpg: /home/username/.gnupg/trustdb.gpg: trustdb created
gpg: key A6310ACC4672475C: public key "AWS CLI Team <aws-cli@amazon.com>" imported
gpg: Total number processed: 1
gpg:               imported: 1

下載您下載之套件的 AWS CLI 簽章檔案。它會有與其對應的 .zip 檔案具有相同的路徑和名稱，但具有副檔名 .sig。在下列範例中，我們將它作為名稱 awscliv2.sig 的檔案儲存在目前的資料夾。

對於最新版本的 AWS CLI，請使用下列命令區塊：
```
$ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip.sig
```

驗證簽章，並將下載的 .sig 和 .zip 檔案名稱以參數形式傳遞給 gpg 命令。


$ gpg --verify awscliv2.sig awscliv2.zip

輸出應看起來如下列內容。


gpg: Signature made Mon Nov  4 19:00:01 2019 PST
gpg:                using RSA key FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
gpg: Good signature from "AWS CLI Team <aws-cli@amazon.com>" [unknown]
gpg: WARNING: This key is not certified with a trusted signature!
gpg:          There is no indication that the signature belongs to the owner.
Primary key fingerprint: FB5D B77F D5C1 18B8 0511  ADA8 A631 0ACC 4672 475C

重要

解壓縮安裝程式。如果您的 Linux 發行版沒有內建 unzip 命令，請使用類似命令解壓縮。下列範例命令會解壓縮套件，並在名為 aws 的目前目錄下建立目錄。
```
$ unzip awscliv2.zip
```
注意
從舊版更新時，unzip 命令會提示覆寫現有檔案。若要略過這些提示 (例如使用指令碼自動化)，對於 unzip 請使用 -u 更新標記。這個標記會視需要自動更新現有檔案和建立新檔案。
```
$ unzip -u awscliv2.zip
```
執行安裝程式。安裝命令會使用新解壓縮的 aws 目錄中名為 install 的檔案。依預設，檔案會全部安裝到 /usr/local/aws-cli，並在 /usr/local/bin 中建立符號連結。命令包括 sudo，以授予寫入權限給這些資料夾。
```
$ sudo ./aws/install
```
如果指定您已具有寫入權限的資料夾，則可以在不使用 sudo 的情況下進行安裝。使用下列 install 命令指示來指定安裝位置：
- 請確定您提供給 -i 和 -b 參數的路徑不包含任何包含空格字元或其他空格字元的磁碟區名稱或目錄名稱。如果有空格，則安裝會失敗。
- --install-dir 或 -i – 此選項指定要將所有檔案複製到的目錄。
  
  預設值為 /usr/local/aws-cli。
- --bin-dir 或 -b – 此選項會指定安裝目錄中的 aws 主程式以符號方式連結至指定路徑的檔案 aws。您必須具有指定目錄的寫入許可。建立路徑中已存在目錄的符號連結，可讓您不需將安裝目錄新增到使用者的 $PATH 變數。
  
  預設值為 /usr/local/bin。
```
$ ./aws/install -i /usr/local/aws-cli -b /usr/local/bin
```
注意
若要更新以此方式建立的安裝，請參閱 AWS CLI 更新指示。
請使用以下命令來確認安裝。
```
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 
```
如果找不到 aws 命令，您可能需要重新啟動終端機或遵循故障診斷的錯誤 AWS CLI 中的故障診斷。

Snap package

我們在 AWS CLI 上提供官方 AWS 支援的版本snap。如果您想要在您的系統上一律 AWS CLI 安裝最新版本的，則 Snap 套件會在自動更新時為您提供此功能。不支援選取的次要版本 AWS CLI ，因此如果您的團隊需要鎖定版本，則它不是最佳安裝方法。如果您想要安裝特定次要版本的 AWS CLI，建議您使用命令列安裝程式。

如果您的 Linux 平台尚未安裝 snap，請在您的平台上安裝 snap。
1. 如需安裝 snap 的資訊，請參閱 Snap 文件中的安裝常駐程式。
2. 您可能需要重新啟動系統，才能正確更新 PATH 變數。如果您有安裝問題，請遵循 Snap 文件中修正常見問題的步驟。
3. 若要確認 snap 已正確安裝，請執行下列命令。
```
$ snap version
```
針對 AWS CLI執行下列 snap install 命令。
```
$ snap install aws-cli --classic
```
根據您的許可，您可能需要將 sudo 新增至命令。
```
$ sudo snap install aws-cli --classic
```
注意
若要檢視的快照儲存庫 AWS CLI，包括其他snap指示，請參閱 Canonical Snapcraft 網站上的 aws-cli頁面。
確認已正確 AWS CLI 安裝。
```
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 
```
如果發生錯誤，請參閱故障診斷的錯誤 AWS CLI。

安裝需求

我們在 macOS 第 11 版及更新版本 AWS CLI 上支援。如需詳細資訊，請參閱AWS 開發人員工具部落格上的 AWS CLI v2 的 macOS 支援政策更新。
由於 AWS 不會維護第三方儲存庫，因此我們無法保證它們包含最新版本的 AWS CLI。

macOS 版本支援矩陣

AWS CLI 版本	支援的 macOS 版本
2.21.0 – 目前版本	11+
2.17.0 –2.20.0	10.15+
2.0.0 – 2.16.12	10.14 及以下版本

安裝 AWS CLI

您可以透過下列方式在 macOS AWS CLI 上安裝。安裝指令碼是建議的方法。若要更新現有的安裝，請參閱 AWS CLI 更新指示。

Install script (recommended)

安裝指令碼會在一個步驟中下載、驗證和安裝 macOS AWS CLI 的。預設會為目前使用者安裝。

若要安裝 AWS CLI，請執行下列命令。


$ curl -fsSL https://awscli.amazonaws.com/v2/install.sh | bash

注意

若要改為為所有使用者安裝（安裝至 /usr/local/aws-cli和 /usr/local/bin)，需要 sudo，請將 --system引數傳遞至指令碼。


$ curl -fsSL https://awscli.amazonaws.com/v2/install.sh | sudo bash -s -- --system

如需選項的完整清單，請使用執行指令碼--help。


$ curl -fsSL https://awscli.amazonaws.com/v2/install.sh | bash -s -- --help

若要更新 AWS CLI，請參閱 AWS CLI 更新指示。

GUI installer

下列步驟說明如何 AWS CLI 使用標準 macOS 使用者介面和瀏覽器安裝最新版本的。

在瀏覽器中下載 macOS pkg 檔案：https://awscli.amazonaws.com/AWSCLIV2.pkg
請依照畫面上的指示，執行您下載的檔案。您可以選擇 AWS CLI 以下列方式安裝：
- 對於電腦上的所有使用者 (需要 sudo)
  - 您可以安裝到任何資料夾，或選擇建議的 /usr/local/aws-cli 的預設資料夾。
  - 安裝程式會自動在 /usr/local/bin/aws 建立符號連結，其連結至您所選擇的安裝資料夾中的主程式。
- 只對於目前的使用者 (不需要 sudo)
  - 您可以安裝到任何具有寫入權限的資料夾。
  - 由於標準的使用者許可，在安裝程式完成之後，您的 $PATH 必須在命令提示字元中使用下列命令，手動建立指向 aws 和 aws_completer 程式的符號連結檔案。符號連結的預設位置為 /usr/local/bin/。
    
    $ ln -s /folder/installed/aws-cli/aws /usr/local/bin/aws $ ln -s /folder/installed/aws-cli/aws_completer /usr/local/bin/aws_completer
    
    如果您沒有資料夾的寫入許可，您可能需要在命令中使用 sudo。下列範例在 /usr/local/bin/ 中搭配使用 sudo 和符號連結的預設位置：
    
    $ sudo ln -s /folder/installed/aws-cli/aws /usr/local/bin/aws $ sudo ln -s /folder/installed/aws-cli/aws_completer /usr/local/bin/aws_completer
注意
您可以在安裝程式中的任何位置按 Cmd+L 來檢視安裝的偵錯日誌。這會開啟一個日誌窗格，使您能夠篩選和儲存日誌。日誌檔也會自動儲存到 /var/log/install.log。
若要確認 Shell 可以在您的 aws 中尋找並執行 $PATH 命令，請使用下列命令。
```
$ which aws
/usr/local/bin/aws 
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Darwin/23.3.0
```
如果找不到 aws 命令，您可能需要重新啟動終端機或遵循故障診斷的錯誤 AWS CLI 中的故障診斷。

Command line installer - All users

如果您具有 sudo 許可，則可以為電腦上的所有使用者安裝 AWS CLI 。我們提供一組易於複製和貼上的步驟。請參閱後續步驟中每一行的描述。


$ curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"
$ sudo installer -pkg AWSCLIV2.pkg -target /

引導式安裝說明

使用 curl 命令下載檔案。在此範例中，-o 選項會指定系統寫入下載套件的檔案名稱。在前述的範例中，檔案會寫入目前的資料夾中的 AWSCLIV2.pkg。
```
$ curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"
```
執行標準 macOS installer 程式，將下載的 .pkg 檔案指定為來源。使用 -pkg 參數可指定要安裝的套件名稱，以及磁碟機要安裝套件的 -target / 參數。檔案會安裝到 /usr/local/aws-cli，並且會在 /usr/local/bin 中自動建立符號連結。您必須在命令上包含 sudo，才能將寫入權限授予這些資料夾。
```
$ sudo installer -pkg ./AWSCLIV2.pkg -target /
```
安裝完成後，偵錯記錄檔會寫入 /var/log/install.log。
若要確認 Shell 可以在您的 aws 中尋找並執行 $PATH 命令，請使用下列命令。
```
$ which aws
/usr/local/bin/aws 
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Darwin/23.3.0
```
如果找不到 aws 命令，您可能需要重新啟動終端機或遵循故障診斷的錯誤 AWS CLI 中的故障診斷。

Command line - Current user

若要指定要安裝 AWS CLI 到哪個資料夾，您必須建立具有任何檔案名稱的 XML 檔案。這個檔案是 XML 格式化的檔案，看起來如下列範例。如圖所示保留所有值，但您必須將第 9 行中的路徑 /Users/myusername 替換為要安裝 AWS CLI 的資料夾路徑。資料夾必須已存在，否則命令會失敗。下列 XML 範例名為 choices.xml，指定安裝程式在資料夾 AWS CLI 中安裝 /Users/myusername，並在其中建立名為的資料夾aws-cli。
```
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <array>
    <dict>
      <key>choiceAttribute</key>
      <string>customLocation</string>
      <key>attributeSetting</key>
      <string>/Users/myusername</string>
      <key>choiceIdentifier</key>
      <string>default</string>
    </dict>
  </array>
</plist>
```
使用 curl 命令下載 pkg 安裝程式。在此範例中，-o 選項會指定系統寫入下載套件的檔案名稱。在前述的範例中，檔案會寫入目前的資料夾中的 AWSCLIV2.pkg。
```
$ curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"
```
現在您可以使用下列選項來執行標準 macOS installer 程式：
- 使用參數 -pkg 指定要安裝的套件的名稱。
- 若要指定僅限目前使用者的安裝，您必須設定參數 -target 為 CurrentUserHomeDirectory。
- 指定您在 -applyChoiceChangesXML 參數中建立的 XML 檔案的路徑 (相對於目前的資料夾) 和名稱。
下列範例會在資料夾 AWS CLI 中安裝 /Users/myusername/aws-cli。
```
$ installer -pkg AWSCLIV2.pkg \
            -target CurrentUserHomeDirectory \
            -applyChoiceChangesXML choices.xml
```
由於標準使用者許可通常不允許寫入 $PATH 中的資料夾，因此此模式下的安裝程式不會嘗試新增連至 aws 和 aws_completer 的符號連結。若要 AWS CLI 讓正確執行，您必須在安裝程式完成後手動建立符號連結。如果您的 $PATH 包含可以寫入的資料夾，則如果將該資料夾指定為目標路徑，則可執行下列命令而無需 sudo。如果您的 $PATH 中沒有可寫入的資料夾，則必須使 sudo 以取得寫入指定目標資料夾的許可。符號連結的預設位置為 /usr/local/bin/。以您的 AWS CLI 安裝路徑替換 folder/installed。
```
$ sudo ln -s /folder/installed/aws-cli/aws /usr/local/bin/aws
$ sudo ln -s /folder/installed/aws-cli/aws_completer /usr/local/bin/aws_completer
```
安裝完成後，偵錯記錄檔會寫入 /var/log/install.log。
若要確認 Shell 可以在您的 aws 中尋找並執行 $PATH 命令，請使用下列命令。
```
$ which aws
/usr/local/bin/aws 
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Darwin/23.3.0
```
如果找不到 aws 命令，您可能需要重新啟動終端機或遵循故障診斷的錯誤 AWS CLI 中的故障診斷。

安裝需求

我們在 Microsoft 支援的 64 位元 Windows 版本 AWS CLI 上支援。
安裝軟體的管理員權限（如果為所有使用者安裝 )。

安裝 AWS CLI

您可以為所有使用者（需要管理員權限）或僅為目前使用者（不需要管理員權限）在 Windows AWS CLI 上安裝。安裝指令碼是建議的方法。我們會 AWS CLI 定期更新；若要查看最新版本，請參閱 GitHub 上的AWS CLI 第 2 版變更日誌。若要更新現有的安裝，請參閱 AWS CLI 更新指示。

Install script (recommended)

安裝指令碼會在一個步驟中下載、驗證和安裝 AWS CLI 適用於 Windows 的。預設會為目前使用者 (%LOCALAPPDATA%\Programs\Amazon\AWSCLIV2) 安裝。

若要安裝 AWS CLI，請從 PowerShell 提示字元執行下列命令。


C:\> irm https://awscli.amazonaws.com/v2/install.ps1 | iex

若要改為為所有使用者安裝（在下安裝Program Files)，這需要提升（管理員） PowerShell 提示，請先將指令碼下載至檔案，然後使用 -System引數執行指令碼。


C:\> irm 'https://awscli.amazonaws.com/v2/install.ps1' -OutFile install.ps1; try { .\install.ps1 -System } finally { Remove-Item install.ps1 }

如需選項的完整清單，-Help請使用相同的模式搭配執行指令碼。


C:\> irm 'https://awscli.amazonaws.com/v2/install.ps1' -OutFile install.ps1; try { .\install.ps1 -Help } finally { Remove-Item install.ps1 }

若要更新 AWS CLI，請參閱 AWS CLI 更新指示。

MSI installer - All users

使用AWSCLIV2.msi安裝程式為機器上的 AWS CLI 所有使用者安裝。此安裝類型需要管理員權限。

下載並執行適用於 Windows 的 AWS CLI MSI 安裝程式 (64 位元）：

https://awscli.amazonaws.com/AWSCLIV2.msi

您也可以執行 msiexec 命令來執行 MSI 安裝程式。
```
C:\> msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2.msi
```
如需可與 msiexec 一起使用的各種參數，請參閱 Microsoft Docs 網站上的 msiexec。例如，您可以使用 /qn 標記進行無訊息安裝。
```
C:\> msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2.msi /qn
```
若要確認安裝，請開啟開始功能表、搜尋 cmd 以開啟命令提示字元視窗，然後在命令提示字元中使用 aws --version 命令。
```
C:\> aws --version
aws-cli/2.27.41 Python/3.11.6 Windows/10 exe/AMD64 prompt/off
```
如果 Windows 找不到程式，您可能需要關閉命令提示字元再重新開啟，以重新整理路徑，或遵循故障診斷的錯誤 AWS CLI 中的故障診斷。

MSI installer - Current user

使用AWSCLIV2-User.msi安裝程式僅 AWS CLI 為目前使用者安裝。此安裝類型不需要管理員權限。安裝命令和 AWS CLI 功能與所有使用者安裝相同。

下載並執行適用於 Windows 的 AWS CLI MSI 安裝程式 (64 位元）：

https://awscli.amazonaws.com/AWSCLIV2-User.msi

您也可以執行 msiexec 命令來執行 MSI 安裝程式。
```
C:\> msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2-User.msi
```
如需可與 msiexec 一起使用的各種參數，請參閱 Microsoft Docs 網站上的 msiexec。例如，您可以使用 /qn 標記進行無訊息安裝。
```
C:\> msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2-User.msi /qn
```
若要確認安裝，請開啟開始功能表、搜尋 cmd 以開啟命令提示字元視窗，然後在命令提示字元中使用 aws --version 命令。
```
C:\> aws --version
aws-cli/2.27.41 Python/3.11.6 Windows/10 exe/AMD64 prompt/off
```
如果 Windows 找不到程式，您可能需要關閉命令提示字元再重新開啟，以重新整理路徑，或遵循故障診斷的錯誤 AWS CLI 中的故障診斷。

AWS CLI 更新指示

如果您 AWS CLI 使用安裝指令碼、官方安裝程式 (Linux 命令列安裝程式、macOS PKG 安裝程式或 Windows MSI 安裝程式）安裝，您可以執行下列命令來更新至最新版本。


$ aws update

如果您 AWS CLI 為所有使用者安裝，aws update請從提升的 shell 執行 (sudo在 Linux 和 macOS 上執行，或在 Windows 上執行管理員 PowerShell 提示）。會aws update保留您現有的安裝是針對所有使用者還是目前使用者。

針對 AWS CLI 安裝和解除安裝錯誤進行故障診斷

如果您在安裝或解除安裝之後遇到問題 AWS CLI，請參閱故障診斷的錯誤 AWS CLI 以取得故障診斷步驟。如需最相關的故障診斷步驟，請參閱命令未找到錯誤、「aws --version」命令傳回的版本與您安裝的版本不同和解除安裝後，「aws --version」命令會傳回版本 AWS CLI。

後續步驟

成功安裝後 AWS CLI，您可以安全地刪除下載的安裝程式檔案。完成中的步驟使用第 2 AWS CLI 版的先決條件並安裝後 AWS CLI，您應該執行設定 AWS CLI。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

先決條件

過去版本