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

# 명령

> 전역 옵션, 출력 형식 및 모든 명령에 대한 페이지가 포함된 CLI 명령 참조입니다.

이 페이지는 XBOX CLI의 명령 참조입니다. 모든 명령이 공유하는 전역 옵션, 출력 형식 및
종료 코드 등 `xbox` 자체를 다룹니다. 아래의 각 명령에는 자체
페이지가 있으며, 각 `playfab` 서비스에는 `commands/playfab/` 아래에 페이지가 있습니다.
터미널에서 동일한 참조를 보려면 `xbox <command> --help`를 실행하세요.

도움말은 CLI 계약이 변경되거나 제거될 수 있는 실험적 명령에 레이블을 표시합니다.
[실험적 명령](https://docs.xbox.com/ko/tools/xbox-cli/cli-command-lifecycle.md)을 참조하세요.

## 핵심 명령

| 명령 | 설명 |
| - | - |
| [`auth`](https://docs.xbox.com/ko/tools/xbox-cli/commands/auth) | Microsoft Entra ID로 인증합니다. |
| [`context`](https://docs.xbox.com/ko/tools/xbox-cli/commands/context) | 이후 명령에서 사용할 판매자 및 PlayFab 타이틀과 같은 기본값을 저장합니다. |
| [`game`](https://docs.xbox.com/ko/tools/xbox-cli/commands/game) | Partner Center 게임을 나열, 가져오기 및 만듭니다. |
| [`seller`](https://docs.xbox.com/ko/tools/xbox-cli/commands/seller) | 로그인한 개발자가 사용할 수 있는 Partner Center 판매자를 나열합니다. |
| [`sandbox`](https://docs.xbox.com/ko/tools/xbox-cli/commands/sandbox) | XBOX 샌드박스를 나열, 가져오기 및 만듭니다. |
| [`audience`](https://docs.xbox.com/ko/tools/xbox-cli/commands/audience) | 판매자의 대상 그룹을 나열, 가져오기, 만들기 및 업데이트합니다(실험적). |
| [`package`](https://docs.xbox.com/ko/tools/xbox-cli/commands/package) | 게임 패키지를 나열하고 가져옵니다(실험적). |
| [`playtest`](https://docs.xbox.com/ko/tools/xbox-cli/commands/playtest) | 게임의 플레이테스트를 나열, 가져오기, 비교, 만들기, 업데이트, 게시 및 삭제합니다. |
| [`pc`](https://docs.xbox.com/ko/tools/xbox-cli/commands/pc) | 이 Windows PC가 사용하는 XBOX 샌드박스를 가져오거나 전환합니다(실험적). |
| [`test-account`](https://docs.xbox.com/ko/tools/xbox-cli/commands/test-account) | XBOX 테스트 계정 배치를 만들고, 업데이트하고, 삭제하며, 생성 작업을 추적하고, 배치를 읽고, 계정의 배치와 액세스 만료 여부를 조회합니다. |
| [`playfab`](https://docs.xbox.com/ko/tools/xbox-cli/commands/playfab) | PlayFab 서비스를 검사하고 관리합니다. |
| [`xbl`](https://docs.xbox.com/ko/tools/xbox-cli/commands/xbl) | XBOX services 구성을 관리합니다(실험적). |

## 지원 명령

| 명령 | 설명 |
| - | - |
| [`info`](https://docs.xbox.com/ko/tools/xbox-cli/commands/info) | 버전 및 시작 링크를 표시합니다. |
| [`upgrade`](https://docs.xbox.com/ko/tools/xbox-cli/commands/upgrade) | 최신 CLI 릴리스를 확인하고 수동 업데이트 지침을 표시합니다. |
| [`feedback`](https://docs.xbox.com/ko/tools/xbox-cli/commands/feedback) | CLI 환경 정보가 포함된 버그 보고서 초안을 엽니다. |
| [`help`](https://docs.xbox.com/ko/tools/xbox-cli/commands/help) | 모든 명령에 대한 도움말을 표시합니다. |

## 전역 옵션

모든 명령은 다음 옵션을 허용합니다. 표에 나와 있듯이 일부 옵션은 특정 명령에만 영향을 주며,
다른 명령에서는 허용되지만 무시됩니다.

| 옵션 | 적용 대상 | 설명 |
| - | - | - |
| `--playfab-title-id <id>` | `playfab` 명령 | 대상으로 지정할 PlayFab 타이틀입니다. `XBOX_PLAYFAB_TITLE_ID` 및 저장된 타이틀보다 우선하며, 둘 다 변경하지 않습니다. [컨텍스트](https://docs.xbox.com/ko/tools/xbox-cli/commands/context.md)를 참조하세요. |
| `--profile <name>` | 저장된 값을 사용하는 명령 | 이 프로필에 저장된 값을 사용합니다. 기본값은 `XBOX_PROFILE`이고, 그다음은 `default`입니다. [프로필](https://docs.xbox.com/ko/tools/xbox-cli/commands/context.md#profiles)을 참조하세요. |
| `--client-id <id>` | 사용자 로그인 | `AzureAd:ClientId`를 재정의합니다. 서비스 주체로 로그인할 때는 거부됩니다. |
| `--tenant-id <id>` | 사용자 로그인 | `AzureAd:TenantId`를 재정의합니다. 서비스 주체로 로그인할 때는 거부됩니다. |
| `--scopes <scopes>` | 로그인 | `AzureAd:Scopes`를 재정의합니다. |
| `--output <format>`, `-o` | 데이터 명령 | `json`(기본값), `json-compact` 또는 지원하는 명령의 경우 `table`입니다. [출력 형식](#output-formats)을 참조하세요. |
| `--data-only` | `playfab` 명령 | PlayFab 응답의 `data` 필드만 작성합니다. [응답 봉투](https://docs.xbox.com/ko/tools/xbox-cli/commands/playfab.md#response-envelope)를 참조하세요. |
| `--confirm`, `--yes`, `-y` | `playfab` 명령 및 해당 페이지에 이 옵션이 나열된 명령 | 먼저 확인을 요청하는 명령의 확인 프롬프트를 건너뜁니다. [안전](https://docs.xbox.com/ko/tools/xbox-cli/safety.md)을 참조하세요. |
| `--verbose` | 모든 명령 | 명령이 사용한 각 [저장된 값](https://docs.xbox.com/ko/tools/xbox-cli/commands/context.md#how-commands-use-saved-values)의 출처를 포함하여 진단 세부 정보를 stderr에 작성합니다. |
| `--disable-telemetry` | 모든 명령 | 이 실행에 대해 익명 제품 사용 원격 분석을 끕니다. [원격 분석](https://docs.xbox.com/ko/tools/xbox-cli/telemetry.md)을 참조하세요. |

옵션은 설정 및 환경 변수보다 우선합니다. [구성](https://docs.xbox.com/ko/tools/xbox-cli/configuration.md)을 참조하세요.

## 출력 형식

데이터 명령은 결과를 stdout에, 오류 및 진단을 stderr에 작성합니다.

| 형식 | 출력 |
| - | - |
| `json` | 서식이 지정된 JSON입니다. 기본값입니다. |
| `json-compact` | `jq` 또는 스크립트로 파이프하기 위한 한 줄 JSON입니다. |
| `table` | 페이지에 허용한다고 명시된 명령의 일반 텍스트 표입니다. |

PlayFab 명령은 각 결과를 `--data-only`가 제거하는 응답 봉투로 래핑합니다.
[응답 봉투](https://docs.xbox.com/ko/tools/xbox-cli/commands/playfab.md#response-envelope)를 참조하세요. `--data-only`는
다른 명령이나 `--output table`과 함께 사용할 때는 효과가 없습니다.

일부 명령은 JSON 대신 사람이 읽을 텍스트를 작성하며, 해당 페이지에 그렇게 명시되어 있습니다. `auth status`는
`--output json` 또는 `--output json-compact`를 전달하지 않으면 텍스트를 작성합니다.
[Auth](https://docs.xbox.com/ko/tools/xbox-cli/commands/auth.md#auth-status)를 참조하세요. `playfab file upload`와 같은 파일 작업은
stdout에 아무것도 작성하지 않고 수행한 작업을 stderr에 보고합니다. [파일](https://docs.xbox.com/ko/tools/xbox-cli/commands/playfab/file.md#output)을 참조하세요.

### 표 출력

표는 터미널에서 읽기 위한 것입니다. 열은 어떤 릴리스에서든 변경될 수 있으므로 스크립트
및 에이전트는 `--output json-compact`를 사용해야 합니다. 표 보기가 없는 명령은
`table`을 거부합니다.

```console theme={null}
$ xbox playfab api /Admin/GetTitleData --output table
Output format 'table' is not available for this command, because it does not declare a
table view. Omit --output to get this command's default output.
```

### 진행률

`game list`처럼 여러 페이지를 읽거나 `xbl config publish`처럼 요청을 기다리는 명령은
stderr의 한 줄에 진행률을 표시합니다.
`Reading games... 1646 found, 25 pages, 84s`. 이 줄은 stderr가 터미널인 경우에만 표시되며,
결과가 나오기 전에 지워집니다.

## 종료 코드

다음 종료 코드는 모든 명령에서 공유됩니다. 무언가를 변경하는 명령은 변경 결과를 알 수 없을 때의 `3`처럼
고유한 종료 코드를 추가할 수 있으며, 해당 페이지에 나열되어 있습니다.

| 종료 코드 | 의미 |
| - | - |
| `0` | 명령이 성공했습니다. |
| `1` | 명령이 실패했습니다. 오류는 stderr에 있습니다. |
| `130` | 명령이 읽거나 대기하는 동안 Ctrl+C를 눌렀습니다. |

실패한 PlayFab 호출은 `--output` 형식으로 오류 JSON을 stderr에 작성합니다.
[PlayFab 오류 응답](https://docs.xbox.com/ko/tools/xbox-cli/playfab-api.md#error-responses)을 참조하세요. 알 수 없는 명령은 오류와
사용법을 stderr에 작성합니다. [도움말](https://docs.xbox.com/ko/tools/xbox-cli/commands/help.md)을 참조하세요.

명령이 변경 사항을 보낸 후 Ctrl+C를 누르면 변경이 적용되었을 수 있는지 여부를 stderr에
표시합니다. 해당 페이지에 문서화된 코드로 종료하며, PlayFab 명령의 경우 `1`로 종료합니다. 다시 실행하기 전에
확인하세요.
[중단된 쓰기는 결과를 알 수 없다고 보고함](https://docs.xbox.com/ko/tools/xbox-cli/safety.md#an-interrupted-write-reports-that-its-outcome-is-unknown)을 참조하세요.

## 안전

많은 명령이 프로덕션 타이틀, 판매자 및 게임을 변경하며, 이름이 `Get`, `List` 또는 `Search`로
시작하는 PlayFab 작업만 읽기 전용입니다. 무언가를 변경하는 명령을 실행하기 전에
[안전 및 파괴적 작업](https://docs.xbox.com/ko/tools/xbox-cli/safety.md)을 읽어 보세요.


## Related topics

- [Serve 명령](https://docs.xbox.com/ko/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-serve-command.md)
- [Notice 명령](https://docs.xbox.com/ko/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-notice-command.md)
- [Pack 명령](https://docs.xbox.com/ko/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-pack-command.md)
- [Convert 명령](https://docs.xbox.com/ko/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-convert-command.md)
- [Verify 명령](https://docs.xbox.com/ko/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-verify-command.md)
