Pular para o conteúdo principal
A XBOX CLI atua com as suas permissões, muitas vezes em títulos e vendedores de produção. Esta página aborda quais comandos apenas leem, quais perguntam antes de alterar algo, os poucos que fazem algo que o nome não indica e o que fazer quando o resultado de uma alteração é desconhecido. Para saber o que um agente de IA precisa perguntar antes de uma alteração, consulte Usar a XBOX CLI a partir de agentes. Um comando obtém o título, o vendedor ou a sandbox de um sinalizador, de uma variável de ambiente XBOX_ ou de um valor salvo com xbox context set. Um comando que altera algo nomeia em stderr cada valor que você não passou na linha de comando; portanto, verifique-o antes de uma alteração de produção. Consulte Contexto.

O que é somente leitura

Uma operação do PlayFab é somente leitura apenas se o nome dela começar com Get, List ou Search, como /Admin/GetTitleData ou /MultiplayerServer/ListBuildSummariesV2. Todas as outras operações alteram algo. Isso é mais importante para xbox playfab api <api-path>, em que você digita o caminho da operação, não o nome de um comando. A Ajuda de um comando tem uma seção SAFETY que informa se ele lê ou altera algo.

O que pergunta primeiro

A maioria dos comandos que alteram algo é executada sem perguntar. Estes perguntam primeiro em um terminal e, sem um terminal, recusam a execução, a menos que você passe --confirm (--yes, -y):

O que o nome de um comando não indica

  • Se playfab service-principal set falhar, a entidade de serviço pode ficar sem acesso no estúdio até que um set seja bem-sucedido, o que pode interromper um pipeline que entra como ela. Passe --expected-version para que set falhe em vez de substituir a alteração de outra pessoa.
  • playfab privacy export envia por email os dados do jogador, de todos os títulos do editor que ele jogou, para o endereço de email de notificação do título. A exportação e o email dela não podem ser cancelados.
  • xbl config publish a partir de outra sandbox substitui os arquivos globais do Title Storage do destino pelos da origem e exclui os arquivos que somente o destino tem. Os arquivos excluídos não podem ser recuperados.
  • xbl config publish --sandbox-id HIDDEN publica a configuração de todo o título, que todas as sandboxes usam, inclusive RETAIL.

Uma gravação interrompida informa que seu resultado é desconhecido

Se uma alteração for interrompida depois que a CLI a enviar, por exemplo, por Ctrl+C, por um tempo limite ou por perda de conexão, ou se o serviço responder com um erro HTTP 5xx, a alteração pode ter sido aplicada. O comando informa que o resultado é desconhecido, como neste erro do PlayFab:
Leia o estado afetado antes de executar a alteração novamente. Os comandos fora de playfab imprimem um comando somente leitura para fazer a verificação. A CLI nunca tenta repetir uma alteração por conta própria. Alguns comandos que aguardam um trabalho saem com 4 quando a solicitação foi aceita, mas a espera terminou. Não os execute novamente; consulte a página do comando para saber como continuar aguardando.
Última modificação em 19 de novembro de 2026