Recuperação remota (xbremoterecovery.exe) - XBOX Game Development Documentation

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	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	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	Recupera o número de versão associado ao software do sistema atualmente em execução no console.
xbremoterecovery getversionid	Recupera a ID de versão associada ao software do sistema atualmente em execução no console.
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:<path to xbProvision manifest>] [/savehostname] [/sethostname:NAME] [/X[:]address[+<accesskey>]]

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[+<accesskey>]	- 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. - Se você não usar esta opção, será usado o console padrão (definido anteriormente por Conexão (xbconnect.exe)). - 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, 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.

Voltar ao início deste tópico.

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. 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.

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.

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.

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.

Veja também

Ferramentas de linha de comando Erros de transporte do XTF Conexão (xbconnect.exe)

​xbremoterecovery install

​xbremoterecovery live

​xbremoterecovery getversion

​xbremoterecovery getversionid

​xbremoterecovery resetresume

​Veja também

xbremoterecovery install

xbremoterecovery live

xbremoterecovery getversion

xbremoterecovery getversionid

xbremoterecovery resetresume

Veja também