Pular para o conteúdo principal
Esta página lista os problemas conhecidos na versão mais recente da XBOX CLI, incluindo recursos inacabados. Se o seu problema estiver listado aqui, você não precisará relatá-lo. Somente a versão mais recente tem suporte. xbox upgrade informa se há uma versão mais recente disponível. Uma entrada marcada como Corrigido foi corrigida na versão mais recente e será removida na próxima.

Se o seu problema não estiver listado

  1. Verifique se você está executando a versão mais recente com xbox upgrade.
  2. Pesquise os problemas existentes.
  3. Se ele não tiver sido relatado, relate-o com xbox feedback, que abre um relatório de bug com os detalhes do seu ambiente preenchidos. Os problemas são públicos; portanto, omita tudo o que você não compartilharia publicamente.

Atualizar a CLI

xbox upgrade falha com HTTP 301

Corrigido O repositório público da CLI foi movido, e xbox upgrade na v0.2.1 falha sempre com HTTP 301: GitHub release metadata is unavailable. Solução alternativa: baixe a versão mais recente seguindo Instalação.

Login e permissões

Alguns comandos ainda não funcionam com uma conta Microsoft pessoal

Quando você entra com uma conta Microsoft pessoal em vez de uma conta corporativa ou de estudante, os comandos de configuração dos serviços do XBOX, contas de teste, pacotes, playtests e públicos não funcionam. Os comandos de configuração dos serviços do XBOX e de contas de teste falham com HTTP 502, informado como serviço indisponível, mas tentar novamente não ajuda. Solução alternativa: associe-se ao seu vendedor no Partner Center com uma conta corporativa ou de estudante e entre na CLI com essa conta.

xbox game, xbox xbl e comandos semelhantes ainda não aceitam entidades de serviço

Uma entidade de serviço pode entrar, mas os comandos audience, game, package, playtest, sandbox, seller, test-account e xbl falham com um erro de autorização quando ela os executa, porque o serviço que eles chamam ainda não aceita entidades de serviço. Solução alternativa: execute esses comandos como um usuário conectado. Os comandos xbox playfab funcionam com uma entidade de serviço depois que uma pessoa concede acesso a ela com xbox playfab service-principal set. Consulte Autenticação de automação (entidade de serviço).

Os comandos são negados para alguns vendedores quando você pertence a mais de um

Se você pertencer a mais de um vendedor do Partner Center, os comandos de configuração dos serviços do XBOX, contas de teste, pacotes, playtests e públicos podem ser negados para todos os vendedores, exceto aquele que você selecionou por último no Partner Center. Solução alternativa: selecione o vendedor desejado no Partner Center e execute o comando novamente.

xbox seller list às vezes omite um dos seus vendedores

Se você pertencer a mais de um vendedor do Partner Center, xbox seller list às vezes omite um deles sem erro, e a próxima execução pode listá-lo. Enquanto ele estiver ausente, os comandos para esse vendedor, como xbox audience list, podem ser negados, e não se sabe se selecioná-lo no Partner Center ajuda.

Os comandos xbox game ignoram --seller-id

xbox game list, xbox game get e xbox game create usam o vendedor que você selecionou por último no Partner Center, não aquele que você passa com --seller-id ou salva no contexto; portanto, game create pode criar o jogo em outro vendedor. Uma ID de vendedor que não é sua, como uma digitada incorretamente, não os faz falhar; eles retornam os seus próprios jogos. Solução alternativa: selecione o vendedor desejado no Partner Center e verifique se xbox game list mostra os jogos dele antes de criar um. A alteração pode levar até 15 minutos para chegar à CLI.

Os comandos xbox sandbox mostram somente sandboxes globais

Quando o vendedor que você passa com --seller-id ou salva no contexto não é aquele que você selecionou por último no Partner Center, xbox sandbox list e xbox sandbox get encontram somente as sandboxes CERT, CERT.DEBUG e RETAIL, sem falhar. xbox sandbox create cria a sandbox no vendedor que você selecionou por último e, se for outro vendedor, sai com 4 porque não consegue ler a sandbox de volta. Não a crie novamente. Solução alternativa: selecione o vendedor desejado no Partner Center e execute o comando novamente com esse vendedor. A alteração pode levar até 15 minutos para chegar à CLI.

Testes com playtests e públicos

xbox audience list pode atingir o tempo limite

xbox audience list pode demorar o suficiente para que a solicitação atinja o tempo limite. --name não ajuda, porque filtra a lista depois que todos os públicos são lidos.

Configuração dos serviços do XBOX

Alguns documentos XML baixados declaram a codificação errada

Alguns documentos XML publicados que xbox xbl config download --view published salva, como mpsdtitleinfo.xml e titlename-localization.xml, declaram encoding="utf-16", mas estão codificados em UTF-8; portanto, um leitor de XML que confia na declaração não consegue carregá-los. Solução alternativa: decodifique o arquivo como UTF-8 antes de analisá-lo.

PlayFab

xbox playfab api /Admin/UpdatePolicy pode substituir a política sem confirmação

Com "OverwritePolicy": true no corpo da solicitação, essa chamada substitui toda a política de acesso à API do título sem as proteções de xbox playfab api-policy set --overwrite: ela não exige --confirm e pode usar o título do contexto salvo ou de XBOX_PLAYFAB_TITLE_ID. Uma política errada pode bloquear o acesso de todos os jogadores ao título. Solução alternativa: use xbox playfab api-policy set --overwrite em vez disso, que exige --confirm e o título passado com --playfab-title-id.

playfab title-data delete e playfab player-data delete não perguntam primeiro

Outros comandos que excluem algo perguntam antes de serem executados ou recusam a execução sem --confirm. Estes dois excluem imediatamente as chaves que você nomeia.

--keys e --member-ids recebem listas separadas por vírgulas

--keys em xbox playfab title-data e xbox playfab player-data, e --member-ids em xbox playfab group member, recebem listas separadas por vírgulas. Elas passarão a ser opções repetidas; portanto, os scripts que as usam precisarão ser atualizados. Até lá, --keys não pode nomear uma chave que contenha uma vírgula. Para ler uma, passe-a com --key, que recebe o nome inteiro, mas delete tem somente --keys. Solução alternativa: para excluir a chave, chame a API que delete usa com xbox playfab api. Para dados de título, defina o valor da chave como null, usando /Admin/SetTitleInternalData no caso de dados internos de título:
Para dados de jogadores, liste a chave em KeysToRemove, usando a API de atualização correspondente à visibilidade dos dados em Dados de jogadores:

Scripts e agentes

A maioria dos comandos sai com 1 quando não se sabe se uma alteração foi aplicada

Alguns comandos saem com 3 quando não conseguem determinar se uma alteração foi feita, como quando a solicitação atinge o tempo limite após ser enviada, e as páginas deles indicam isso. Todos os outros comandos, incluindo todos os comandos do PlayFab, saem com 1 em qualquer falha; portanto, um script não consegue distinguir esse caso de uma alteração que não foi feita. Solução alternativa: quando um comando que altera algo falhar, verifique o estado atual antes de executá-lo novamente.
Última modificação em 19 de novembro de 2026