本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 安裝 AWS CLI 第 2 版的過去版本
本主題說明如何在支援的作業系統上安裝 第 2 AWS Command Line Interface 版 (AWS CLI) 的過去版本。如需 AWS CLI 第 2 版的資訊，請參閱 GitHub 上的第 [AWS CLI 2 版變更日誌](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst)。
AWS CLI 第 2 版安裝說明：
## Linux
### 安裝要求
+ 您知道想要安裝的 第 2 AWS CLI 版版本。如需版本清單，請參閱 [GitHub](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) 上的 *AWS CLI 第 2 版變更日誌*。
+ 您必須能夠解壓縮或「解壓縮」下載的套件。如果您的作業系統沒有內建 `unzip` 命令，請使用對等的命令。
+ 第 2 AWS CLI 版使用 `glibc`、 `groff`和 `less`。依預設，這些會包含在 Linux 的大多數主要發行版中。
+ 我們支援 CentOS、Fedora、Ubuntu、Amazon Linux AWS CLI 1、Amazon Linux 2 和 Linux ARM 最近發行版本的 64 位元版本 2。
+ 由於 AWS 不會維護第三方儲存庫，因此我們無法保證它們包含最新版本的 AWS CLI。
### 安裝說明
請依照命令列中的下列步驟，在 Linux AWS CLI 上安裝 。
我們會根據您使用 64 位元 Linux 或 Linux ARM，在一個易於複製和貼上群組中提供步驟。請參閱後續步驟中每一行的描述。
------
#### [ Linux x86 (64-bit) ]
**注意**
**（選用）** 下列命令區塊會下載並安裝 ， AWS CLI 而無需先驗證下載的完整性。若要驗證下載的完整性，請使用以下逐步說明。
如需版本清單，請參閱 [GitHub](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) 上的 *AWS CLI 第 2 版變更日誌*。
**若要安裝** AWS CLI，請執行下列命令。
若要指定版本，請在檔案名稱中附加連字號和版本號碼。在這個範例中，版本 *2.0.30* 的檔案名稱為 `awscli-exe-linux-x86_64-2.0.30.zip`，因此使用以下命令：
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.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-x86_64-2.0.30.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update
```
------
#### [ Linux ARM ]
**注意**
**（選用）** 下列命令區塊會下載並安裝 ， AWS CLI 而無需先驗證下載的完整性。若要驗證下載的完整性，請使用以下逐步說明。
如需版本清單，請參閱 [GitHub](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) 上的 *AWS CLI 第 2 版變更日誌*。
**若要安裝** AWS CLI，請執行下列命令。
若要指定版本，請在檔案名稱中附加連字號和版本號碼。在這個範例中，版本 *2.0.30* 的檔案名稱為 `awscli-exe-linux-aarch64-2.0.30.zip`，因此使用以下命令：
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.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-2.0.30.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update
```
------
1. 使用下列其中一種方式下載安裝檔案：
------
#### [ Linux x86 (64-bit) ]
+ **使用 `curl` 命令** – `-o` 選項會指定已下載套件寫入的檔案名稱。下列範例命令的選項會使下載的檔案以本機時間 `awscliv2.zip` 寫入目前的目錄。
若要指定版本，請在檔案名稱中附加連字號和版本號碼。在這個範例中，版本 *2.0.30* 的檔案名稱為 `awscli-exe-linux-x86_64-2.0.30.zip`，因此使用以下命令：
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip" -o "awscliv2.zip"
```
如需版本清單，請參閱 [GitHub](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) 上的 *AWS CLI 第 2 版變更日誌*。
+ **從 URL 下載**–
在您的瀏覽器中，將連字號和版本號碼附加至檔案名稱， AWS CLI 以下載特定版本的 。
```
https://awscli.amazonaws.com/awscli-exe-linux-x86_64-version.number.zip
```
在此範例中，版本 *2.0.30* 的檔案名為 awscli-exe-linux-x86\$164-2.0.30.zip，因此使用以下連結：[https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip](https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip)
------
#### [ Linux ARM ]
+ **使用 `curl` 命令** – `-o` 選項會指定已下載套件寫入的檔案名稱。下列範例命令的選項會使下載的檔案以本機時間 `awscliv2.zip` 寫入目前的目錄。
若要指定版本，請在檔案名稱中附加連字號和版本號碼。在這個範例中，版本 *2.0.30* 的檔案名稱為 `awscli-exe-linux-aarch64-2.0.30.zip`，因此使用以下命令：
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install
```
+ **從 URL 下載**–
在您的瀏覽器中，將連字號和版本號碼附加至檔案名稱， AWS CLI 以下載特定版本的 。
```
https://awscli.amazonaws.com/awscli-exe-linux-aarch64-version.number.zip
```
在這個範例中，版本 *2.0.30* 的檔案名稱為 `awscli-exe-linux-aarch64-2.0.30.zip`，因此使用以下連結：[https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip](https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip)
------
1. **(可選) 驗證所下載 zip 檔案的完整性**
如果您選擇`.zip`在上述步驟中手動下載 AWS CLI 安裝程式套件，則可以使用 `GnuPG`工具，使用下列步驟來驗證簽章。
AWS CLI 安裝程式套件`.zip`檔案使用 PGP 簽章進行密碼編譯簽署。如果檔案有任何損壞或更改，此驗證會失敗，且您不應該繼續進行安裝。
1. 使用您的套件管理工具下載並安裝 `gpg` 命令。如需有關 `GnuPG` 的詳細資訊，請參閱 [GnuPG 網站](https://www.gnupg.org/)。
1. 若要建立公開金鑰檔案，請建立文字檔案，然後貼上下列文字。
```
-----BEGIN PGP PUBLIC KEY BLOCK-----
mQINBF2Cr7UBEADJZHcgusOJl7ENSyumXh85z0TRV0xJorM2B/JL0kHOyigQluUG
ZMLhENaG0bYatdrKP+3H91lvK050pXwnO/R7fB/FSTouki4ciIx5OuLlnJZIxSzx
PqGl0mkxImLNbGWoi6Lto0LYxqHN2iQtzlwTVmq9733zd3XfcXrZ3+LblHAgEt5G
TfNxEKJ8soPLyWmwDH6HWCnjZ/aIQRBTIQ05uVeEoYxSh6wOai7ss/KveoSNBbYz
gbdzoqI2Y8cgH2nbfgp3DSasaLZEdCSsIsK1u05CinE7k2qZ7KgKAUIcT/cR/grk
C6VwsnDU0OUCideXcQ8WeHutqvgZH1JgKDbznoIzeQHJD238GEu+eKhRHcz8/jeG
94zkcgJOz3KbZGYMiTh277Fvj9zzvZsbMBCedV1BTg3TqgvdX4bdkhf5cH+7NtWO
lrFj6UwAsGukBTAOxC0l/dnSmZhJ7Z1KmEWilro/gOrjtOxqRQutlIqG22TaqoPG
fYVN+en3Zwbt97kcgZDwqbuykNt64oZWc4XKCa3mprEGC3IbJTBFqglXmZ7l9ywG
EEUJYOlb2XrSuPWml39beWdKM8kzr1OjnlOm6+lpTRCBfo0wa9F8YZRhHPAkwKkX
XDeOGpWRj4ohOx0d2GWkyV5xyN14p2tQOCdOODmz80yUTgRpPVQUtOEhXQARAQAB
tCFBV1MgQ0xJIFRlYW0gPGF3cy1jbGlAYW1hem9uLmNvbT6JAlQEEwEIAD4CGwMF
CwkIBwIGFQoJCAsCBBYCAwECHgECF4AWIQT7Xbd/1cEYuAURraimMQrMRnJHXAUC
aGveYQUJDMpiLAAKCRCmMQrMRnJHXKBYD/9Ab0qQdGiO5hObchG8xh8Rpb4Mjyf6
0JrVo6m8GNjNj6BHkSc8fuTQJ/FaEhaQxj3pjZ3GXPrXjIIVChmICLlFuRXYzrXc
Pw0lniybypsZEVai5kO0tCNBCCFuMN9RsmmRG8mf7lC4FSTbUDmxG/QlYK+0IV/l
uJkzxWa+rySkdpm0JdqumjegNRgObdXHAQDWlubWQHWyZyIQ2B4U7AxqSpcdJp6I
S4Zds4wVLd1WE5pquYQ8vS2cNlDm4QNg8wTj58e3lKN47hXHMIb6CHxRnb947oJa
pg189LLPR5koh+EorNkA1wu5mAJtJvy5YMsppy2y/kIjp3lyY6AmPT1posgGk70Z
CmToEZ5rbd7ARExtlh76A0cabMDFlEHDIK8RNUOSRr7L64+KxOUegKBfQHb9dADY
qqiKqpCbKgvtWlds909Ms74JBgr2KwZCSY1HaOxnIr4CY43QRqAq5YHOay/mU+6w
hhmdF18vpyK0vfkvvGresWtSXbag7Hkt3XjaEw76BzxQH21EBDqU8WJVjHgU6ru+
DJTs+SxgJbaT3hb/vyjlw0lK+hFfhWKRwgOXH8vqducF95NRSUxtS4fpqxWVaw3Q
V2OWSjbne99A5EPEySzryFTKbMGwaTlAwMCwYevt4YT6eb7NmFhTx0Fis4TalUs+
j+c7Kg92pDx2uQ==
=OBAt
-----END PGP PUBLIC KEY BLOCK-----
```
以下公開金鑰詳細資訊僅供參考。
```
Key ID: A6310ACC4672
Type: RSA
Size: 4096/4096
Created: 2019-09-18
Expires: 2026-07-07
User ID: AWS CLI Team
Key fingerprint: FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
```
1. 使用下列命令匯入 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 " imported
gpg: Total number processed: 1
gpg: imported: 1
```
1. 下載您下載之套件的 AWS CLI 簽章檔案。它會有與其對應的 `.zip` 檔案具有相同的路徑和名稱，但具有副檔名 `.sig`。在下列範例中，我們將它作為名稱 `awscliv2.sig` 的檔案儲存在目前的資料夾。
------
#### [ Linux x86 (64-bit) ]
**對於最新版本的 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](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) 上的 *AWS CLI 第 2 版變更日誌*。
------
#### [ Linux ARM ]
**對於最新版本的 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](https://github.com/aws/aws-cli/blob/v2/CHANGELOG.rst?plain=1) 上的 *AWS CLI 第 2 版變更日誌*。
------
1. 驗證簽章，並將下載的 `.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 " [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 金鑰之間沒有信任鏈。如需詳細資訊，請參閱「[信任網路](https://en.wikipedia.org/wiki/Web_of_trust)」。
1. 解壓縮安裝程式。如果您的 Linux 發行版沒有內建 `unzip` 命令，請使用類似命令解壓縮。下列範例命令會解壓縮套件，並在名為 `aws` 的目前目錄下建立目錄。
```
$ unzip awscliv2.zip
```
1. 執行安裝程式。安裝命令會使用新解壓縮的 `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 版本 2 的目前安裝更新至較新版本，請新增現有的符號連結和安裝程式資訊，以使用 `--update` 參數建構 `install`命令。
```
$ sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update
```
若要找到現有的符號連結和安裝目錄，請執行以下步驟：
使用 `which` 命令來查找您的符號連結。這提供您與 `--bin-dir` 參數一起使用的路徑。
```
$ which aws
/usr/local/bin/aws
```
使用 `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
```
1. 請使用以下命令來確認安裝。
```
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64
```
如果找不到 `aws` 命令，您可能需要重新啟動終端機或遵循 [故障診斷 的錯誤 AWS CLI](cli-chap-troubleshooting.md) 中的故障診斷。
## macOS
### 安裝要求
+ 您知道想要安裝的 第 2 AWS CLI 版版本。如需版本清單，請參閱 [GitHub](https://github.com/aws/aws-cli/blob/v2/CHANGELOG.rst?plain=1) 上的 *AWS CLI 第 2 版變更日誌*。
+ 我們支援 Apple AWS CLI 支援的 64 位元 macOS 版本 2。
+ 由於 AWS 不會維護第三方儲存庫，因此我們無法保證它們包含最新版本的 AWS CLI。
### 安裝說明
您可以透過下列方式在 macOS 上安裝 第 2 AWS CLI 版。
------
#### [ GUI installer ]
以下步驟說明如何使用標準 macOS 使用者界面和瀏覽器來安裝或更新至 AWS CLI 第 2 版的最新版本。如果您要更新至最新版本，請使用您目前版本所使用的相同安裝方法。
1. 在您的瀏覽器中，將連字號和版本號碼附加至檔案名稱， AWS CLI 以下載特定版本的 。
```
https://awscli.amazonaws.com/AWSCLIV2-version.number.pkg
```
在這個範例中，版本 *2.0.30* 的檔案名稱為 `AWSCLIV2-2.0.30.pkg`，因此使用以下連結：[https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg](https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg)。
1. 請依照畫面上的指示，執行您下載的檔案。您可以選擇以下列方式安裝第 2 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\$1L** 來檢視安裝的偵錯日誌。這會開啟一個日誌窗格，使您能夠篩選和儲存日誌。日誌檔也會自動儲存到 `/var/log/install.log`。
1. 若要確認 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](cli-chap-troubleshooting.md) 中的故障診斷。
------
#### [ Command line installer - All users ]
如果您有`sudo`許可，您可以為電腦上的所有使用者安裝 第 2 AWS CLI 版。我們提供一組易於複製和貼上的步驟。請參閱後續步驟中每一行的描述。
對於特定版本的 AWS CLI，請將連字號和版本號碼附加至檔案名稱。在這個範例中，版本 *2.0.30* 的檔案名稱為 `AWSCLIV2-2.0.30.pkg`，因此使用以下命令：
```
$ curl "https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg" -o "AWSCLIV2.pkg"
$ sudo installer -pkg AWSCLIV2.pkg -target /
```
1. 使用 `curl` 命令下載檔案。在此範例中，`-o` 選項會指定系統寫入下載套件的檔案名稱。在前述的範例中，檔案會寫入目前的資料夾中的 `AWSCLIV2.pkg`。
對於特定版本的 AWS CLI，請將連字號和版本號碼附加至檔案名稱。在這個範例中，版本 *2.0.30* 的檔案名稱為 `AWSCLIV2-2.0.30.pkg`，因此使用以下命令：
```
$ curl "https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg" -o "AWSCLIV2.pkg"
```
如需版本清單，請參閱 [GitHub](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) 上的 *AWS CLI 第 2 版變更日誌*。
1. 執行標準 macOS `installer` 程式，將下載的 `.pkg` 檔案指定為來源。使用 `-pkg` 參數可指定要安裝的套件名稱，以及磁碟機要安裝套件的 `-target /` 參數。檔案會安裝到 `/usr/local/aws-cli`，並且會在 `/usr/local/bin` 中自動建立符號連結。您必須在命令上包含 `sudo`，才能將寫入權限授予這些資料夾。
```
$ sudo installer -pkg ./AWSCLIV2.pkg -target /
```
安裝完成後，偵錯記錄檔會寫入 `/var/log/install.log`。
1. 若要確認 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](cli-chap-troubleshooting.md) 中的故障診斷。
------
#### [ Command line - Current user ]
1. 若要指定要安裝 AWS CLI 的資料夾，您必須建立 XML 檔案。這個檔案是 XML 格式化的檔案，看起來如下列範例。保留所有值，如下所示，但您必須將第 9 行中的路徑 */Users/myusername* 取代為要安裝第 2 AWS CLI 版之資料夾的路徑。*資料夾必須已存在，否則命令會失敗。*此 XML 範例指定安裝程式在資料夾 AWS CLI 中安裝 `/Users/myusername`，並在其中建立名為 的資料夾`aws-cli`。
```
choiceAttribute
customLocation
attributeSetting
/Users/myusername
choiceIdentifier
default
```
1. 使用 `curl` 命令下載 `pkg` 安裝程式。在此範例中，`-o` 選項會指定系統寫入下載套件的檔案名稱。在前述的範例中，檔案會寫入目前的資料夾中的 `AWSCLIV2.pkg`。
對於 的特定版本 AWS CLI，請將連字號和版本號碼附加至檔案名稱。在這個範例中，版本 *2.0.30* 的檔案名稱為 `AWSCLIV2-2.0.30.pkg`，因此使用以下命令：
```
$ curl "https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg" -o "AWSCLIV2.pkg"
```
如需版本清單，請參閱 [GitHub](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) 上的 *AWS CLI 第 2 版變更日誌*。
1. 現在您可以使用下列選項來執行標準 macOS `installer` 程式：
+ 使用參數 `-pkg` 指定要安裝的套件的名稱。
+ 若要指定*僅限目前使用者*的安裝，您必須設定參數 `-target` 為 `CurrentUserHomeDirectory`。
+ 指定您在 `-applyChoiceChangesXML` 參數中建立的 XML 檔案的路徑 (相對於目前的資料夾) 和名稱。
下列範例會在 資料夾 AWS CLI 中安裝 `/Users/myusername/aws-cli`。
```
$ installer -pkg AWSCLIV2.pkg \
-target CurrentUserHomeDirectory \
-applyChoiceChangesXML choices.xml
```
1. 由於標準使用者許可通常不允許寫入 `$PATH` 中的資料夾，因此此模式下的安裝程式不會嘗試新增連至 `aws` 和 `aws_completer` 的符號連結。若要 AWS CLI 讓 正確執行，您必須在安裝程式完成後手動建立符號連結。如果您的 `$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
```
安裝完成後，偵錯記錄檔會寫入 `/var/log/install.log`。
1. 若要確認 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](cli-chap-troubleshooting.md) 中的故障診斷。
------
## Windows
### 安裝要求
+ 您知道想要安裝的 第 2 AWS CLI 版版本。如需版本清單，請參閱 [GitHub](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) 上的 *AWS CLI 第 2 版變更日誌*。
+ 我們在 Microsoft 支援的 64 位元 Windows 版本 AWS CLI 上支援 。
+ 安裝軟體的管理員權限
### 安裝說明
若要更新目前在 Windows 上安裝的第 2 AWS CLI 版，請在每次更新時下載新的安裝程式以覆寫先前的版本。 AWS CLI 會定期更新。若要檢視最新版本發佈的時間，請參閱 *GitHub* 上的 [AWS CLI 第 2 版變更日誌](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst)。
1. 以下列其中一種方式下載並執行適用於 Windows 的 AWS CLI MSI 安裝程式 (64 位元）：
+ **下載並執行 MSI 安裝程式：**若要為特定版本的 建立下載連結 AWS CLI，請將連字號和版本編號附加至檔案名稱。
```
https://awscli.amazonaws.com/AWSCLIV2-version.number.msi
```
在這個範例中，版本 *2.0.30* 的檔案名稱為 `AWSCLIV2-2.0.30.msi`，因此使用以下連結：[https://awscli.amazonaws.com/AWSCLIV2-2.0.30.msi](https://awscli.amazonaws.com/AWSCLIV2-2.0.30.msi)。
+ **使用 Msiexec 命令：**或者，您也可以使用 MSI 安裝程式，方法是將連結新增至 `msiexec` 命令。對於特定版本的 AWS CLI，請將連字號和版本號碼附加至檔案名稱。
```
C:\> msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2-version.number.msi
```
在這個範例中，版本 *2.0.30* 的檔案名稱為 `AWSCLIV2-2.0.30.msi`，因此使用以下連結：[https://awscli.amazonaws.com/AWSCLIV2-2.0.30.msi](https://awscli.amazonaws.com/AWSCLIV2-2.0.30.msi)。
```
C:\> msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2-2.0.30.msi
```
如需可與 `msiexec` 一起使用的各種參數，請參閱 *Microsoft Docs* 網站上的 [msiexec](https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/msiexec)。
如需版本清單，請參閱 [GitHub](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) 上的 *AWS CLI 第 2 版變更日誌*。
1. 若要確認安裝，請開啟**開始**功能表、搜尋 `cmd` 以開啟命令提示字元視窗，然後在命令提示字元中使用 `aws --version` 命令。
```
C:\> aws --version
aws-cli/2.27.41 Python/3.11.6 Windows/10 exe/AMD64 prompt/off
```
如果 Windows 找不到程式，您可能需要關閉命令提示字元再重新開啟，以重新整理路徑，或遵循 [故障診斷 的錯誤 AWS CLI](cli-chap-troubleshooting.md) 中的故障診斷。
## 針對 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)。
## 後續步驟
完成 [使用第 2 AWS CLI 版的先決條件](getting-started-prereqs.md) 中的步驟並安裝 AWS CLI後，則應執行 [設定 AWS CLI](getting-started-quickstart.md)。