安裝或更新至最新版本的 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

yum 安裝 AWS CLI 之後，請依照下列 Linux 安裝指示進行。

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

命令列安裝程式是版本控制的好選項，因為您可以指定要安裝的版本。此選項不會自動更新，而且您每次更新時都必須下載新的安裝程式，以覆寫先前的版本。
正式支援的snap套件是讓一律擁有最新版本的好選擇， AWS CLI 因為 Snap 套件會自動重新整理。不支援選取的次要版本 AWS CLI ，因此，如果您的團隊需要鎖定版本，則不是最佳安裝方法。

Command line installer - Linux x86 (64-bit)

若要更新目前安裝的 AWS CLI，請在每次更新時下載新的安裝程式以覆寫先前的版本。請依照命令列中的下列步驟，在 Linux 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

若要更新 AWS CLI目前的安裝，新增現有的符號連結和安裝程式資訊,以使用 --bin-dir、--install-dir 和 --update 參數建構 install 命令。下列命令區塊使用 /usr/local/bin 的範例符號連結和 /usr/local/aws-cli 的範例安裝程式位置，為目前使用者在 AWS CLI 本機安裝。


$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update

引導式安裝步驟

使用下列其中一種方式下載安裝檔案：
- 使用 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:          2025-07-24
User ID:          AWS CLI Team <[email protected]>
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 <[email protected]>" 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
```
對於特定版本的 AWS CLI，請將連字號和版本號碼附加至檔案名稱。在這個範例中，版本 2.0.30 的檔案名稱為 awscli-exe-linux-x86_64-2.0.30.zip.sig，因此使用以下命令：
```
$ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip.sig
```
如需版本清單，請參閱 GitHub 上的 AWS CLI 第 2 版變更日誌。

驗證簽章，並將下載的 .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 <[email protected]>" [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，請新增現有的符號連結和安裝程式資訊，以使用 --update 參數建構 install命令。
```
$ sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update
```
若要找到現有的符號連結和安裝目錄，請執行以下步驟：
1. 使用 which 命令來查找您的符號連結。這提供您與 --bin-dir 參數一起使用的路徑。
  
  $ which aws /usr/local/bin/aws
2. 使用 ls 命令來查找符號連結指向的目錄。這提供您與 --install-dir 參數一起使用的路徑。
  
  $ ls -l /usr/local/bin/aws lrwxrwxrwx 1 ec2-user ec2-user 49 Oct 22 09:49 /usr/local/bin/aws -> /usr/local/aws-cli/v2/current/bin/aws
請使用以下命令來確認安裝。
```
$ aws --version
aws-cli/2.19.1 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/2.4.5
```
如果找不到 aws 命令，您可能需要重新啟動終端機或遵循故障診斷的錯誤 AWS CLI 中的故障診斷。

Command line - Linux ARM

若要更新目前安裝的 AWS CLI，請在每次更新時下載新的安裝程式以覆寫先前的版本。請依照命令列中的下列步驟，在 Linux 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

若要更新 AWS CLI目前的安裝，新增現有的符號連結和安裝程式資訊,以使用 --bin-dir、--install-dir 和 --update 參數建構 install 命令。下列命令區塊使用 /usr/local/bin 的範例符號連結，以及 /usr/local/aws-cli 的範例安裝程式位置。


$ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update

引導式安裝步驟

使用下列其中一種方式下載安裝檔案：
- 使用 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:          2025-07-24
User ID:          AWS CLI Team <[email protected]>
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 <[email protected]>" 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
```
對於特定版本的 AWS CLI，請將連字號和版本號碼附加至檔案名稱。在這個範例中，版本 2.0.30 的檔案名稱為 awscli-exe-linux-aarch64-2.0.30.zip.sig，因此使用以下命令：
```
$ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip.sig
```
如需版本清單，請參閱 GitHub 上的 AWS CLI 第 2 版變更日誌。

驗證簽章，並將下載的 .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 <[email protected]>" [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，請新增現有的符號連結和安裝程式資訊，以使用 --update 參數建構 install命令。
```
$ sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update
```
若要找到現有的符號連結和安裝目錄，請執行以下步驟：
1. 使用 which 命令來查找您的符號連結。這提供您與 --bin-dir 參數一起使用的路徑。
  
  $ which aws /usr/local/bin/aws
2. 使用 ls 命令來查找符號連結指向的目錄。這提供您與 --install-dir 參數一起使用的路徑。
  
  $ ls -l /usr/local/bin/aws lrwxrwxrwx 1 ec2-user ec2-user 49 Oct 22 09:49 /usr/local/bin/aws -> /usr/local/aws-cli/v2/current/bin/aws
請使用以下命令來確認安裝。
```
$ aws --version
aws-cli/2.19.1 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/2.4.5
```
如果找不到 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
```
針對執行下列snap install命令 AWS CLI。
```
$ snap install aws-cli --classic
```
根據您的許可，您可能需要將 sudo 新增至命令。
```
$ sudo snap install aws-cli --classic
```
注意
若要檢視的 Snap 儲存庫 AWS CLI，包括其他snap指示，請參閱 Canonical Snapcraft 網站上的 aws-cli頁面。

確認已正確 AWS CLI 安裝。


$ aws --version
aws-cli/2.19.1 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/2.4.5

如果發生錯誤，請參閱故障診斷的錯誤 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 上安裝。

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 程式的符號連結檔案。如果您的 $PATH 包含可以寫入的資料夾，則如果將該資料夾指定為目標路徑，則可執行下列命令而無需 sudo。如果您在 $PATH 中沒有可寫入的資料夾，則必須在命令中使用 sudo，以取得寫入指定目標資料夾的許可。符號連結的預設位置為 /usr/local/bin/。
    
    $ 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.19.1 Python/3.11.6 Darwin/23.3.0 botocore/2.4.5
```
如果找不到 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.19.1 Python/3.11.6 Darwin/23.3.0 botocore/2.4.5
```
如果找不到 aws 命令，您可能需要重新啟動終端機或遵循故障診斷的錯誤 AWS CLI 中的故障診斷。

Command line - Current user

若要指定要安裝 AWS CLI 的資料夾，您必須建立具有任何檔案名稱的 XML 檔案。這個檔案是 XML 格式化的檔案，看起來如下列範例。如圖所示保留所有值，但您必須將第 9 行中的路徑 /Users/myusername 替換為要安裝 AWS CLI 的資料夾路徑。資料夾必須已存在，否則命令會失敗。下列名為 choices.xml 的 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.19.1 Python/3.11.6 Darwin/23.3.0 botocore/2.4.5
```
如果找不到 aws 命令，您可能需要重新啟動終端機或遵循故障診斷的錯誤 AWS CLI 中的故障診斷。

安裝和更新需求

我們在 Microsoft 支援的 64 位元 Windows 版本 AWS CLI 上支援。
安裝軟體的管理員權限

安裝或更新 AWS CLI

若要更新目前在 Windows AWS CLI 上安裝的，請在每次更新時下載新的安裝程式以覆寫先前的版本。 AWS CLI 會定期更新。若要檢視最新版本發佈的時間，請參閱 GitHub 上的 AWS CLI 第 2 版變更日誌。

下載並執行適用於 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.19.1 Python/3.11.6 Windows/10 exe/AMD64 prompt/off
```
如果 Windows 找不到程式，您可能需要關閉命令提示字元再重新開啟，以重新整理路徑，或遵循故障診斷的錯誤 AWS CLI 中的故障診斷。

重要

主題

AWS CLI 安裝和更新指示

安裝和更新需求

安裝或更新 AWS CLI

警告

注意

引導式安裝步驟

重要

注意

注意

注意

引導式安裝步驟

重要

注意

注意

注意

安裝和更新需求

安裝或更新 AWS CLI

注意

引導式安裝說明

安裝和更新需求

安裝或更新 AWS CLI

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

後續步驟