> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# POST (/ext/unattendedsetup/quickaction)

> POST (/ext/unattendedsetup/quickaction)

# POST (/ext/unattendedsetup/quickaction)

變更指派給其中一個前面板按鈕的指令碼，或在目標 XBOX One 開發主機上執行其中一個前面板指令碼。

* [URI 參數](#ID4EX)
* [必要的要求標頭](#ID4E5)
* [必要的要求本文](#ID4EFB)
* [選用的要求本文](#ID4EZB)
* [回應](#ID4EMB)

## URI 參數

| 參數 | 類型 | 描述 |
| - | - | - |
| ButtonNumber | number | 選用數字，表示要處理的前面板按鈕編號。如果未提供此值，則此要求會將新的自訂指令碼新增至主機。 |
| Name | base64 編碼字串 | 選用字串，表示要套用至按鈕的指令碼名稱。如果未提供此值，則會改為執行目前與 ButtonNumber 相關聯的指令碼。 |
| IsBuiltIn | boolean | 選用布林值，指出要套用的指令碼是系統提供的內建指令碼，還是使用者先前新增至主機的自訂指令碼。 |

## 必要的要求標頭

無。

## 必要的要求本文

無。

## 選用的要求本文

如果未提供 ButtonNumber，則呼叫需要符合多部分格式的 HTTP 本文，其中包含要新增至主機的指令碼檔案。

## 回應

如果呼叫成功且要求為執行與按鈕相關聯的動作，服務會傳回具有下列成員的 JSON 物件：

| 成員 | 類型 | 描述 |
| - | - | - |
| Output | string | 執行與所要求按鈕相關聯之指令碼的輸出。 |

如果呼叫是要將指令碼套用至按鈕或新增新的自訂指令碼，則沒有回應本文。

### HTTP 狀態碼

服務會傳回本節中的其中一個狀態碼，以回應使用此方法對此資源所提出的要求。

| 代碼 | 描述 |
| - | - |
| 200/204 | 作業成功。 |
| 4XX | 錯誤碼。 |
| 5XX | 錯誤碼。 |

## 另請參閱

##### 父項

[/ext/unattendedsetup/quickaction](https://docs.xbox.com/zh-TW/reference/deviceportal/unattendedsetup/uri-extunattendedsetupquickaction.md)


## Related topics

- [/ext/unattendedsetup/quickaction (API 內容)](https://docs.xbox.com/zh-TW/reference/deviceportal/unattendedsetup/uri-extunattendedsetupquickaction.md)
- [GET (/ext/unattendedsetup/quickaction)](https://docs.xbox.com/zh-TW/reference/deviceportal/unattendedsetup/uri-extunattendedsetupquickaction-get.md)
- [POST (/ext/unattendedsetup/default)](https://docs.xbox.com/zh-TW/reference/deviceportal/unattendedsetup/uri-extunattendedsetupdefault-post.md)
- [POST (/ext/unattendedsetup/test)](https://docs.xbox.com/zh-TW/reference/deviceportal/unattendedsetup/uri-extunattendedsetuptest-post.md)
- [POST (/ext/unattendedsetup/apply)](https://docs.xbox.com/zh-TW/reference/deviceportal/unattendedsetup/uri-extunattendedsetupapply-post.md)