• 2026 年 4 月 30 日之後將不再提供 AWS Systems Manager CloudWatch Dashboard。客戶可以繼續使用 Amazon CloudWatch 主控台來檢視、建立和管理其 Amazon CloudWatch 儀表板，就像現在一樣。如需詳細資訊，請參閱 [Amazon CloudWatch Dashboard 文件](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 在 macOS 上安裝 Session Manager 外掛程式
<a name="install-plugin-macos-overview"></a>

選擇下列其中一個主題，以在 macOS 上安裝 Session Manager 外掛程式。

**注意**  
已簽署的安裝程式是已簽署的 `.pkg` 檔案。綁定的安裝程式會使用 `.zip` 檔案。將該檔案解壓縮後，您可以使用二進位檔案來安裝外掛程式。

## 在 macOS 上安裝 Session Manager 外掛程式與已簽署的安裝程式
<a name="install-plugin-macos-signed"></a>

本節說明如何使用已簽署的安裝程式在 macOS 上安裝 Session Manager 外掛程式。

**若要使用已簽署的安裝程式安裝 Session Manager 外掛程式 (macOS)**

1. 下載已簽署的安裝程式。

------
#### [ x86\_64 ]

   ```
   curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/mac/session-manager-plugin.pkg" -o "session-manager-plugin.pkg"
   ```

------
#### [ 搭載 Apple 晶片的 Mac ]

   ```
   curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/mac_arm64/session-manager-plugin.pkg" -o "session-manager-plugin.pkg"
   ```

------

1. 執行安裝命令。如果命令失敗，請驗證 `/usr/local/bin` 資料夾是否存在。如果不存在，請建立該資料夾，然後再次執行命令。

   ```
   sudo installer -pkg session-manager-plugin.pkg -target /
   sudo ln -s /usr/local/sessionmanagerplugin/bin/session-manager-plugin /usr/local/bin/session-manager-plugin
   ```

1. 確認已安裝成功。如需相關資訊，請參閱[驗證 Session Manager 外掛程式安裝](install-plugin-verify.md)。

## 在 macOS 上安裝 Session Manager 外掛程式
<a name="install-plugin-macos"></a>

本節說明如何使用隨附的安裝程式在 macOS 上安裝 Session Manager 外掛程式。

**重要**  
記下以下重要資訊。  
依預設，安裝程式需要 sudo 存取權才能執行，因為指令碼會將外掛程式安裝至 `/usr/local/sessionmanagerplugin` 系統目錄。如果您不想使用 sudo 安裝外掛程式，請手動更新安裝程式指令碼，將外掛程式安裝至不需要 sudo 存取權的目錄。
Bundled Installer 無法安裝到包含空格的路徑。

**使用 Bundled Installer (macOS) 安裝 Session Manager 外掛程式**

1. 下載 Bundled Installer。

------
#### [ x86\_64 ]

   ```
   curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/mac/sessionmanager-bundle.zip" -o "sessionmanager-bundle.zip"
   ```

------
#### [ 搭載 Apple 晶片的 Mac ]

   ```
   curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/mac_arm64/sessionmanager-bundle.zip" -o "sessionmanager-bundle.zip"
   ```

------

1. 解壓縮套件。

   ```
   unzip sessionmanager-bundle.zip
   ```

1. 執行安裝命令。

   ```
   sudo ./sessionmanager-bundle/install -i /usr/local/sessionmanagerplugin -b /usr/local/bin/session-manager-plugin
   ```
**注意**  
 外掛程式需要 Python 3.10 或更新版本。根據預設，安裝指令碼會在系統預設版本的 Python 下執行。如果您已安裝其他版本的 Python，並想使用該版本軟體安裝 Session Manager 外掛程式，請使用該版本按 Python 可執行檔的絕對路徑來執行安裝指令碼。下列是 範例。  

   ```
   sudo /usr/local/bin/python3.11 sessionmanager-bundle/install -i /usr/local/sessionmanagerplugin -b /usr/local/bin/session-manager-plugin
   ```

   安裝程式會將 Session Manager 外掛程式安裝到 `/usr/local/sessionmanagerplugin`，並在 `/usr/local/bin` 目錄中建立符號連結 `session-manager-plugin`。這讓您無須在使用者的 `$PATH` 變動指定安裝的目錄。

   若要參閱 `-i` 和 `-b` 選項的說明，請使用 `-h` 選項。

   ```
   ./sessionmanager-bundle/install -h
   ```

1. 確認已安裝成功。如需相關資訊，請參閱[驗證 Session Manager 外掛程式安裝](install-plugin-verify.md)。

**注意**  
若要解除安裝外掛程式，請按顯示的順序執行以下兩個命令。  

```
sudo rm -rf /usr/local/sessionmanagerplugin
```

```
sudo rm /usr/local/bin/session-manager-plugin
```