> ## 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. # Recuperação remota (xbremoterecovery.exe) > Recuperação remota (xbremoterecovery.exe) Use esta ferramenta para iniciar uma atualização do sistema em consoles da família XBOX One e consoles XBOX Series. Essa ferramenta permite obter atualizações do sistema a partir de um destino em um PC local, dos serviços XBOX ou de uma CDN personalizada. Essa ferramenta fornece os subcomandos e funções a seguir. | Comando | Descrição | | - | - | | [xbremoterecovery install](#xbremoterecovery_install) | Instala uma atualização do sistema Live baixando dados do PC. Os serviços XBOX devem autorizar o console a instalar a atualização. | | [xbremoterecovery live](#xbremoterecovery_live) | Instala uma atualização do sistema Live baixando dados da nuvem. Requer que os serviços XBOX autorizem o console a instalar a atualização. | | [xbremoterecovery getversion](#xbremoterecovery_getversion) | Recupera o número de versão associado ao software do sistema atualmente em execução no console. | | [xbremoterecovery getversionid](#xbremoterecovery_getversionid) | Recupera a ID de versão associada ao software do sistema atualmente em execução no console. | | [xbremoterecovery resetresume](#xbremoterecovery_resetresume) | Limpa as atualizações em andamento para que a próxima tentativa inicie uma nova atualização. | ## xbremoterecovery install Instala uma atualização do sistema Live baixando dados do PC. Os serviços XBOX devem autorizar o console a instalar a atualização. | Coluna 1 | | - | | \*\*xbremoterecovery install \*\**update\_path* \[/factoryreset\[:VALUE] ] \[/log] \[/noidletimeout] \[/xblsandbox:VALUE] \[/provision:\] \[/savehostname] \[/sethostname:NAME] \[/X\[:]*address\[+\]*] | | Opção | Descrição | | - | - | | *update\_path* | O caminho para um diretório que contém os arquivos de dados da atualização do sistema.
Por exemplo, system.xvd, host.xvd, updater.xvd e update.ini. | | /factoryreset\[:VALUE] | Força a redefinição de todas as configurações e do armazenamento interno.
**Sem valor** - Executa uma redefinição completa de todas as configurações e do conteúdo para o estado padrão.
**savesettings** - Preserva as configurações durante a redefinição de fábrica. | | /log | Gera conteúdo adequado para um arquivo de log. | | /noidletimeout | Desabilita o temporizador de desligamento por inatividade. Isso é útil para testar um cenário em que o usuário nunca quer que o console se desligue por inatividade. | | /xblsandbox:VALUE | Substitui a sandbox padrão. Isso é especialmente útil na primeira vez que um console é configurado, porque todo console começa na sandbox RETAIL, o que não é prático para Development Kits. Essa opção deve ser usada na primeira vez que um kit de desenvolvimento for recuperado para garantir que ele vá para a sandbox correta. | | /savehostname | Use essa opção ao fazer downgrade de um build quando quiser preservar o nome do host do console. Usar essa opção com /factoryreset preservará o nome do host. | | /sethostname:NAME | Semelhante a /savehostname, mas substituirá o nome do host pelo NAME fornecido. | | /X\[:]*address\[+\]* | - Use esta opção para especificar o nome do host ou o endereço (mostrado como **Tools IP** no console) de um console de destino sem alterar o console padrão. Para obter detalhes sobre como definir um nome de host para um console, veja [Definir um nome de host para o endereço IP do console](/pt-BR/home/setup-install/dev-kit-settings/setting-a-hostname).
- Se você não usar esta opção, será usado o console padrão (definido anteriormente por [Conexão (xbconnect.exe)](/pt-BR/tools/tools-console/commandlinetools/xbconnect)).
- Use a string *accesskey* para fornecer acesso ao console somente às pessoas que têm a chave de acesso.
- Defina a chave de acesso usando o comando **xbconfig** **accesskey=your-key** e, em seguida, reinicie o console para que a chave de acesso entre em vigor.
- Para acessar um console configurado com uma chave de acesso, inclua um sinal de adição (+) e a chave de acesso após o endereço IP ou o nome do host do console.
- Se uma chave de acesso for fornecida quando o console padrão for definido por [xbconnect](/pt-BR/tools/tools-console/commandlinetools/xbconnect), a chave de acesso será armazenada como parte do endereço do console padrão.
- Para obter mais informações sobre chaves de acesso, veja [xbconfig accesskey](/pt-BR/tools/tools-console/commandlinetools/xbconfig). | [Voltar ao início deste tópico.](/pt-BR/tools/tools-console/commandlinetools/xbremoterecovery) ## xbremoterecovery live Instala uma atualização do sistema Live baixando dados da nuvem. Requer que os serviços XBOX autorizem o console a instalar a atualização. | Coluna 1 | | - | | **xbremoterecovery live \[VERSIONID] \[/cdnoverride:VALUE]** | | Opção | Descrição | | - | - | | VERSIONID | A ID de versão exata a ser instalada, no formato x.x.xxxx.x.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Se um console de desenvolvedor estiver configurado para atualizações manuais, VERSIONID será um parâmetro obrigatório. Caso contrário, omitir esse parâmetro fará a atualização para a versão mais recente disponível para o System Update Group do console. O valor de VERSIONID pode ser determinado de uma das seguintes formas: 1. Inspecione o arquivo update.ini em um .zip de recuperação baixado de [https://aka.ms/gdkdl](https://aka.ms/gdkdl). Por exemplo, esta é a ID de versão da atualização de recuperação QFE 1 de março de 2021: `VersionId=10.0.19041.6737.31cedb80-46ab-407b-b277-1c67bd056f4c` 2. Execute `xbremoterecovery.exe` com a opção de linha de comando `getversionid`. | | /cdnoverride:VALUE | Substitui o valor de CDN retornado pelos serviços XBOX por um ponto de extremidade de CDN personalizado. Recomenda-se fornecer o parâmetro VERSIONID ao usar essa opção. O caminho completo para todos os arquivos de atualização precisará ser o seguinte: `\|----- CDN override value ----\|-------------- Version ID of the build -------------\| Flat directory of update files \|` `http://example.com/xboxupdates/10.0.19041.6288.afaf9289-dc86-45ab-9515-02554081a1e8/*` | [Voltar ao início deste tópico.](/pt-BR/tools/tools-console/commandlinetools/xbremoterecovery) ## xbremoterecovery getversion Recupera o número de versão associado ao software do sistema atualmente em execução no console. | Coluna 1 | | - | | \*\*xbremoterecovery getversion \*\* | [Voltar ao início deste tópico.](/pt-BR/tools/tools-console/commandlinetools/xbremoterecovery) ## xbremoterecovery getversionid Recupera a ID de versão associada ao software do sistema atualmente em execução no console. Essa ID pode ser usada como o valor de VERSIONID ao executar o comando xbremoterecovery live. | Coluna 1 | | - | | \*\*xbremoterecovery getversionid \*\* | [Voltar ao início deste tópico.](/pt-BR/tools/tools-console/commandlinetools/xbremoterecovery) ## xbremoterecovery resetresume Limpa as atualizações em andamento para que a próxima tentativa inicie uma nova atualização. | Coluna 1 | | - | | \*\*xbremoterecovery resetresume \*\* | Em alguns casos, a recuperação falha, mas deixa esse sinalizador definido para indicar que uma atualização está em andamento. Essa opção limpa o sinalizador para que as atualizações subsequentes possam prosseguir. Opcionalmente, reinicie o console para limpar esse sinalizador. [Voltar ao início deste tópico.](/pt-BR/tools/tools-console/commandlinetools/xbremoterecovery) ## Veja também [Ferramentas de linha de comando](/pt-BR/tools/tools-console/commandlinetools/commandlinetools) [Erros de transporte do XTF](/pt-BR/tools/tools-console/commandlinetools/xtf-transport-errors) [Conexão (xbconnect.exe)](/pt-BR/tools/tools-console/commandlinetools/xbconnect) ## Related topics - [Ferramentas de linha de comando para desenvolvimento em console](/pt-BR/tools/tools-console/commandlinetools/commandlinetools.md) - [Ferramentas de linha de comando](/pt-BR/tools/tools-console/commandlinetools/index.md) - [URIs de recuperação remota](/pt-BR/reference/deviceportal/remote/atoc-rest-remote.md) - [Recuperação (wdRecovery.exe)](/pt-BR/tools/tools-console/console_commandlinetools/wdrecovery.md) - [Referência da API REST do Windows Device Portal](/pt-BR/reference/deviceportal/atoc-deviceportal-reference.md)