本文適用於： ✔️ Aspire CLI 9.4.0 和更新版本。
Note
此命令預設為停用。 若要使用它，請執行下列命令來開啟功能切換：
aspire config set features.execCommandEnabled true
如需詳細資訊，請參閱 aspire config 命令。
Name
aspire exec - 執行 Aspire AppHost 以對資源執行命令。
Important
此命令處於預覽狀態，而且可能會變更。
Synopsis
aspire exec [options] [[--] <additional arguments>...]
Description
此命令 aspire exec 會在 AppHost 中定義的其中一個資源內容中執行命令。
您必須指定 --resource 或是 --start-resource 選項，而且您必須提供參數給 -- 選項。
Aspire CLI 會使用下列邏輯來判斷要處理的 AppHost 專案：
選項
--project。這個選項會指定要處理之項目的路徑。
設定檔
.aspire/settings.json。如果組態檔路徑存在於目前目錄中，則會使用它。 如果沒有找到，CLI 會往上尋找目錄結構中的配置檔案。 如果找到組態檔，它會讀取
appHostPath設定值做為要處理的專案。搜尋目前的目錄和子目錄。
從目前目錄開始，CLI 會從該目錄和下方收集所有 AppHost 專案。 如果探索到單一專案，則會自動選取該專案。 如果發現多個專案，則會列印到終端機，讓使用者手動選取其中一個專案。
一旦專案被自動或手動選擇，專案的路徑就會儲存在
.aspire/settings.json組態檔中。
選項
有下列選項可供使用：
--從資源的參數分隔
aspire exec的參數。 這個分隔符之後的所有自變數都會傳遞至資源。-
--projectAppHost 專案檔案的路徑 Aspire。
-r, --resource要對其執行命令的目標資源名稱。
-s, --start-resource要啟動和執行命令的目標資源名稱。
-
-?, -h, --help列印可用命令和選項的說明和使用說明檔。
-
-d, --debug啟用對主控台的偵錯記錄，主控台會列印有關執行命令時 CLI 正在執行的動作 Aspire 的詳細資訊。
-
--wait-for-debugger請等候調試程式附加，再執行命令。
Examples
建置並執行AppHost專案，然後將命令
migrate傳送至database1資源：aspire exec --resource database1 -- migrate
