> ## 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. # Ferramenta de criação de scripts > Ferramenta de criação de scripts Use esta ferramenta para criar rapidamente novos scripts de configuração autônoma para os XBOX Development Kits escolhendo entre uma ampla seleção de ações predefinidas. A ferramenta de criação de scripts está disponível tanto no [XBOX Device Portal (Windows Device Portal no XBOX)](/pt-BR/tools/tools-console/wdp/wdp), conforme mostrado na figura 1, quanto no [XBOX Manager](/pt-BR/tools/tools-console/xbom/xbom). **Figura 1. Interface principal da ferramenta de criação de scripts no XBOX Device Portal** ![Interface principal da ferramenta de criação de scripts no XBOX Device Portal](https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/script_authoring_tool_full.png?fit=max\&auto=format\&n=6TXzXmujKayly5Sf\&q=85\&s=efebc9087edc659670808ef5614b4e5a) Este tópico contém as seções a seguir. * [Abrir a ferramenta de criação de scripts](#open_tool) * [Criar um novo script](#create_script) * [Adicionar, editar e reordenar ações de script](#add_actions) * [Exportar e importar scripts](#save_script) * [Implantar e limpar um script de inicialização](#deploy_script) * [Cancelar um script de inicialização](#abort_script) * [Invocar scripts pelo painel frontal do kit de desenvolvimento XBOX One X](#front_panel) ## Abrir a ferramenta de criação de scripts A ferramenta de criação de scripts está incluída no [XBOX Device Portal (Windows Device Portal no XBOX)](/pt-BR/tools/tools-console/wdp/wdp) e é hospedada no [XBOX Manager](/pt-BR/tools/tools-console/xbom/xbom). Para abrir a ferramenta no XBOX Device Portal, vá para o workspace **Automation** no painel esquerdo, conforme mostrado na figura 2. **Figura 2. Workspaces no XBOX Device Portal** ![Workspaces no XBOX Device Portal](https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/script_authoring_tool_workspaces.png?fit=max\&auto=format\&n=6TXzXmujKayly5Sf\&q=85\&s=027aaad669b0a2edf7cd8ef66c99f934) Se você não encontrar o workspace Automation, adicione as ferramentas de automação a um novo workspace seguindo as etapas abaixo. 1. Selecione **Menu** no canto superior esquerdo e, em seguida, selecione **New workspace**. 2. Insira um nome para o novo workspace e, em seguida, selecione **Add**. 3. No novo workspace, selecione **Menu** e, em seguida, selecione **Add tools to workspace**. 4. Na lista de ferramentas, selecione **XBOX automation** e **XBOX unattended settings** e, em seguida, selecione **Add**. ## Criar um novo script Se você já estiver trabalhando em um script, considere exportar ou implantar o script em que está trabalhando *antes* de selecionar **New script**. Para criar um novo script, selecione **New script** em **Automation** ou no seu workspace personalizado. Isso limpa o script atual e redefine **Script Name** como "New Script". > ![cuidado](https://mintcdn.com/microsoft-4404708b/z-rLYkO3Ax6HPtgm/images/gdk/tools/caution.gif?s=c35e42b8bb5ca0bdac12d10f6c467c29)**CUIDADO:** Ir para um workspace diferente do XBOX Device Portal tem o mesmo efeito que selecionar **New script**. Para evitar perder seu trabalho, abra o novo workspace em uma nova guia do navegador. ## Adicionar, editar e reordenar ações de script As ações de script são tarefas de automação individuais que você pode combinar para criar um script. O editor de scripts mantém uma tabela das ações que você adicionou. Essa tabela fica em branco em um script recém-criado. À medida que você adiciona novas ações, novas linhas são adicionadas à tabela, conforme mostrado na figura 3. **Figura 3. Tabela de ações na ferramenta de criação de scripts** ![Tabela de ações na ferramenta de criação de scripts](https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/script_authoring_tool_action_table.png?fit=max\&auto=format\&n=6TXzXmujKayly5Sf\&q=85\&s=a1bb4117498919672d24a64c2866943f) Para adicionar uma nova ação a um script, selecione **New action**. Isso exibe a caixa de diálogo New action, que contém listas categorizadas com dezenas de tarefas e configurações programáveis que você pode adicionar ao script. Para isso, escolha uma categoria, selecione a ação desejada na lista e, em seguida, selecione **Next** para concluir a adição da ação ao script, conforme mostrado na figura 4. **Figura 4. Caixa de diálogo New action na ferramenta de criação de scripts** ![Caixa de diálogo New action na ferramenta de criação de scripts](https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/script_authoring_tool_new_action.png?fit=max\&auto=format\&n=6TXzXmujKayly5Sf\&q=85\&s=88bbcd6d04a80cbfecce476991526425) Para editar uma ação existente, selecione o nome dessa ação na tabela. Depois de criar um script com várias ações, você pode alterar a ordem em que as ações são executadas selecionando o link **move up** ou **move down** na coluna **Actions**. Para excluir uma ação, selecione o link **delete** na coluna **Actions**, conforme mostrado na figura 3. ## Exportar e importar scripts Para salvar o script, selecione **Export** e salve-o usando a caixa de diálogo de arquivo padrão. O script é salvo em um arquivo de texto chamado "*scriptname*.xboxunattend". (Observe que o botão Export não fica disponível se o script não contiver nenhuma ação.) Os scripts salvos podem ser importados e implantados posteriormente em outro console ou em uma unidade USB. Para editar scripts exportados anteriormente, importe-os para a ferramenta de criação de scripts. Para importar um script, selecione **Import** e navegue até o arquivo .xboxunattend que contém o script. ## Implantar e limpar um script de inicialização Para executar automaticamente um script sempre que você reiniciar o kit de desenvolvimento, importe o script para a ferramenta e selecione **Apply as boot script**. Isso copia o script para um script de comando chamado *xd:\boot\boot.cmd* no kit de desenvolvimento. Sempre que o kit de desenvolvimento é reiniciado, ele abre o [Developer Home no console (Dev Home)](/pt-BR/tools/tools-console/devhome/devhome) (o padrão para kits de desenvolvimento) ou a tela inicial de varejo, dependendo das preferências selecionadas, e executa o script de inicialização cerca de 20 a 30 segundos depois. Para remover o script de inicialização atual do console, selecione **Clear stored script**. Esse botão fica disponível sempre que o XBOX Device Portal está conectado a um console que tem um script de inicialização implantado. ## Cancelar um script de inicialização Quando o kit de desenvolvimento é reiniciado, o sistema mostra a notificação a seguir, conforme mostrado na figura 5, por padrão, antes que o script de inicialização seja executado. **Figura 5. Notificação do script de inicialização** ![Notificação do script de inicialização](https://mintcdn.com/microsoft-4404708b/6TXzXmujKayly5Sf/images/gdk/tools/script_authoring_tool_notification.png?fit=max\&auto=format\&n=6TXzXmujKayly5Sf\&q=85\&s=db76c8550c11652e9134cec333ca9980) Essa notificação permite cancelar um script perigoso. Por exemplo, um script que reinicia o console não é uma boa opção como script de inicialização, pois resultaria em um loop infinito de reinicialização. Para cancelar um script, mantenha pressionado o botão XBOX no controle quando essa notificação aparecer. A notificação de cancelamento é habilitada por padrão e adiciona um pequeno tempo à sequência de inicialização. Para desabilitar essa notificação, selecione a opção **Run scripts immediately on startup** em **Unattended script settings**, conforme mostrado na figura 1. ## Invocar scripts pelo painel frontal do kit de desenvolvimento XBOX One X O kit de desenvolvimento XBOX One X tem um visor de painel frontal integrado e cinco botões programáveis. Você pode configurar qualquer um desses botões para executar uma ação personalizada quando o botão for pressionado. Isso inclui tanto ações integradas quanto ações personalizadas que você cria usando a ferramenta de criação de scripts. Para mapear um script para um botão do painel frontal, selecione **Add for front panel buttons** na ferramenta de criação de scripts para copiar o script para o kit de desenvolvimento. Em seguida, siga as instruções em [Gerenciar a automação do console](/pt-BR/tools/tools-console/xbom/manager-tool-automation) para remapear o botão para o seu script personalizado. > [!NOTE] > > Este recurso só aparece quando o XBOX Device Portal está conectado a um kit de desenvolvimento XBOX One X. ## Related topics - [XBOX Device Portal (Windows Device Portal no XBOX)](/pt-BR/tools/tools-console/wdp/wdp.md) - [Referência da API de ferramentas](/pt-BR/reference/tools/gc-reference-tools-toc.md) - [XMemCreateWin32Heap](/pt-BR/reference/system/xmem/functions/xmemcreatewin32heap.md) - [Referência da ferramenta de linha de comando do Touch Adaptation Kit (TAK)](/pt-BR/build/core-features/common/game-streaming/tak-command-line-tool/index.md) - [Ferramenta de contas de teste (XblTestAccountGui.exe)](/pt-BR/tools/tools-services/live-xbox-live-account-tool.md)