> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.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)

<a id="ID4EX" />

## URI 參數

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

<a id="ID4E5" />

## 必要的要求標頭

無。

<a id="ID4EFB" />

## 必要的要求本文

無。

<a id="ID4EZB" />

## 選用的要求本文

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

<a id="ID4EMB" />

## 回應

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

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

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

<a id="ID4ESB" />

### HTTP 狀態碼

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

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

<a id="ID4EZC" />

## 另請參閱

<a id="ID4E2C" />

##### 父項

[/ext/unattendedsetup/quickaction](/zh-TW/reference/deviceportal/unattendedsetup/uri-extunattendedsetupquickaction)


## Related topics

- [Unattended Setup URIs](/reference/deviceportal/unattendedsetup/atoc-rest-unattendedsetup.md)
- [URIs de configuração autônoma](/pt-BR/reference/deviceportal/unattendedsetup/atoc-rest-unattendedsetup.md)
- [URI de configuración desatendida](/es/reference/deviceportal/unattendedsetup/atoc-rest-unattendedsetup.md)
- [URI de configuration sans assistance](/fr/reference/deviceportal/unattendedsetup/atoc-rest-unattendedsetup.md)
- [自動安裝 URI](/zh-TW/reference/deviceportal/unattendedsetup/atoc-rest-unattendedsetup.md)