> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Problemas conhecidos

> Problemas e recursos inacabados na versão mais recente da XBOX CLI e como contorná-los.

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`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/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`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/upgrade).
2. Pesquise os [problemas existentes](https://github.com/xbox/cli/issues).
3. Se ele não tiver sido relatado, relate-o com [`xbox feedback`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/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`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/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](https://docs.xbox.com/pt-BR/tools/xbox-cli/installation.md).

## 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`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/playfab/service-principal). Consulte
[Autenticação de automação (entidade de serviço)](https://docs.xbox.com/pt-BR/tools/xbox-cli/authentication.md#automation-service-principal-authentication).

### 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`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/seller)
à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`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/audience), 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`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/game) usam o vendedor que você
selecionou por último no Partner Center, não aquele que você passa com `--seller-id` ou salva no
[contexto](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/context.md); 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](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/context.md) não é
aquele que você selecionou por último no Partner Center,
[`xbox sandbox list` e `xbox sandbox get`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/sandbox) 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`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/audience) 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`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/xbl) 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`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/playfab/api-policy)
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`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/playfab/group), 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`](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/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:

```bash theme={null}
xbox --playfab-title-id ABC123 playfab api /Admin/SetTitleData --body '{"Key":"Level,Bonus","Value":null}'
```

Para dados de jogadores, liste a chave em `KeysToRemove`, usando a API de atualização correspondente à
visibilidade dos dados em [Dados de jogadores](https://docs.xbox.com/pt-BR/tools/xbox-cli/commands/playfab/player-data.md):

```bash theme={null}
xbox --playfab-title-id ABC123 playfab api /Admin/UpdateUserData --body '{"PlayFabId":"PLAYER123","KeysToRemove":["Level,Bonus"]}'
```

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


## Related topics

- [Introdução ao Unity para desenvolvimento para PC (conteúdo)](https://docs.xbox.com/pt-BR/build/gdk-and-engines/unity/unity.md)
- [Notas de versão - XBOX PC Remote Tools (março de 2026)](https://docs.xbox.com/pt-BR/tools/tools-pc/xbox-pc-remote-tools/release-notes/2603.md)
- [Perguntas frequentes e guia de solução de problemas das XBOX PC Remote Tools](https://docs.xbox.com/pt-BR/tools/tools-pc/xbox-pc-remote-tools/faq.md)
- [Usar o Playtest](https://docs.xbox.com/pt-BR/publishing/game-publishing/concepts/playtest-preview.md)
- [Notas de suporte do GDK para o Visual Studio 2019](https://docs.xbox.com/pt-BR/tools/tools-console/visualstudio/vs-2019-support-notes.md)
