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

# PC

> XblPCSandbox.exe처럼 이 Windows PC가 사용하는 XBOX 샌드박스를 가져오거나 전환합니다.

`pc` 명령은 이 Windows PC가 사용하는 XBOX 샌드박스를 가져오거나 전환합니다. 이러한 명령은 실험적 기능이며
Windows에서만 실행됩니다. [실험적 명령](https://docs.xbox.com/ko/tools/xbox-cli/cli-command-lifecycle.md)을 참조하세요.

PC는 한 번에 하나의 샌드박스를 PC의 모든 사용자와 모든 게임에 사용하며, 게임은 해당 샌드박스에
로그인합니다. 기본값은 `RETAIL`입니다. `ABCDEF.1` 같은 개발 샌드박스에서 게임을 테스트하려면 먼저 PC를
해당 샌드박스로 전환하세요. Partner Center 계정에 어떤 샌드박스가 있는지 보려면
[`xbox sandbox list`](https://docs.xbox.com/ko/tools/xbox-cli/commands/sandbox)를 사용하세요.

## 명령

각 명령은 XBOX 서비스 PC 샌드박스 전환기인 `XblPCSandbox.exe`를 실행하며,
[해당 설명서](https://learn.microsoft.com/gaming/gdk/docs/tools/tools-services/live-pc-sandbox-switcher)에
설명된 대로 작동합니다.

| 명령 | 동일한 명령 | 설명 |
| - | - | - |
| `pc sandbox get` | `XblPCSandbox /get` | 이 PC가 사용하는 샌드박스를 가져옵니다. |
| `pc sandbox set <sandbox-id>` | `XblPCSandbox /set <sandbox-id>` 또는 `/retail` | 이 PC를 샌드박스로 전환하거나 `RETAIL`로 되돌립니다. |
| `pc sandbox launch-apps` | `XblPCSandbox /launchApps` | 이 PC의 샌드박스에서 Microsoft Store와 XBOX 앱을 닫았다가 다시 엽니다. |

도구의 `/feedback` 명령은 `XblPCSandbox /feedback`을 직접 실행하세요.

## 샌드박스 전환

```bash theme={null}
xbox pc sandbox set ABCDEF.1 --confirm
```

`pc sandbox set`은 PC의 모든 사용자에 대한 샌드박스를 변경합니다. 전환하기 전에 묻고, 그런 다음 관리자
권한을 위한 사용자 계정 컨트롤(UAC) 프롬프트를 표시합니다. PC의 XBOX 서비스를 다시 시작하고, Microsoft
Store와 XBOX 앱이 열려 있었다면 다시 엽니다. 그런 다음 PC가 새 샌드박스를 사용하는지 확인합니다.

`set`은 PC가 이미 해당 샌드박스를 사용하고 있어도 전환합니다. 다시 실행하면 서비스가 다시 시작되므로,
로그인이 여전히 이전 샌드박스를 사용하는 문제가 해결됩니다. 그래도 해결되지 않으면 PC를 다시 시작하고
[샌드박스 문제 해결](https://aka.ms/XboxLiveSandboxHelp)을 참조하세요.

Microsoft Store에서 XBOX 앱 또는 Gaming Services를 업데이트하기 전에 `RETAIL`로 전환하세요.

## 도구 설치

`XblPCSandbox.exe`는 XBOX Game Development Kit(GDK)와 함께 제공되며,
[XBOX 서비스 개발 도구 릴리스](https://github.com/microsoft/xbox-live-developer-tools/releases) 페이지의
`XboxLiveTools.zip`에도 포함되어 있습니다. PC에서 XBOX 기능을 실행하는 Windows 서비스인 Gaming Services가
설치되어 있어야 합니다. CLI는 다음 순서로 도구를 찾습니다.

1. `XBOX_XBLPCSANDBOX__PATH` 환경 변수 같은 `XblPCSandbox:Path` 설정.
2. CLI가 포함된 폴더.
3. `PATH`에 있는 각 폴더.

## 옵션

| 옵션 | 명령 | 설명 |
| - | - | - |
| `--confirm`, `--yes`, `-y` | `set` | 확인 프롬프트 없이 전환합니다. 대화형 터미널 밖에서는 필수입니다. |
| `--no-apps` | `set` | 도구의 `/noApps`처럼 Microsoft Store와 XBOX 앱을 다시 열지 않습니다. 나중에 `launch-apps`를 실행하여 다시 여세요. |
| `--output <format>` | 모두 | `json`(기본값), `json-compact` 또는 `table`. |

## 출력

`get`과 `launch-apps`는 `{"sandbox": "ABCDEF.1"}`을 반환하고, `set`은
`{"sandbox": "ABCDEF.1", "previousSandbox": "RETAIL"}`을 반환합니다. `--output table`을 사용하면 열은
`SANDBOX`이며, `set`의 경우 `PREVIOUS SANDBOX`도 있습니다. 도구 자체의 출력은 stderr로 출력됩니다.

## 오류

| 원인 | 결과 |
| - | - |
| UAC 프롬프트가 거부됨 | 샌드박스가 변경되지 않습니다. |
| Gaming Services가 없거나 작동하지 않음 | 도구의 출력에 원인이 표시되며, 오류에 Gaming Services 복구 도구 링크가 포함됩니다. |
| 전환이 적용되지 않음 | 도구가 성공을 보고했지만 PC가 다른 샌드박스를 사용합니다. 전환을 다시 실행하고, 그래도 실패하면 PC를 다시 시작하세요. |
| 도구를 찾을 수 없음 | 오류에 CLI가 찾아본 위치와 도구를 설치하는 방법이 표시됩니다. |
| Ctrl+C를 누름 | CLI가 도구를 중지합니다. UAC 프롬프트를 수락했다면 전환이 계속 완료될 수 있으므로 `xbox pc sandbox get`으로 확인하세요. |

도구의 오류에는 [샌드박스 문제 해결](https://aka.ms/XboxLiveSandboxHelp) 링크가 포함되며, 문제를 보고하려면
`XblPCSandbox /feedback`을 사용하도록 제안합니다.

## 예제

이 PC가 사용하는 샌드박스를 가져옵니다.

```bash theme={null}
xbox pc sandbox get
```

Microsoft Store와 XBOX 앱을 다시 열지 않고 개발 샌드박스로 전환한 다음, 앱을 다시 엽니다.

```bash theme={null}
xbox pc sandbox set ABCDEF.1 --confirm --no-apps
xbox pc sandbox launch-apps
```

`RETAIL`로 다시 전환합니다.

```bash theme={null}
xbox pc sandbox set RETAIL --confirm
```


## Related topics

- [PC Bootstrapper](https://docs.xbox.com/ko/build/gdk-and-engines/guides/pc-bootstrapper.md)
- [PC 게임 등록](https://docs.xbox.com/ko/tools/tools-pc/title-registration-pc.md)
- [PC 포트 동작](https://docs.xbox.com/ko/build/console-features/networking/game-mesh/pc-port-behavior.md)
- [XBOX PC Remote Tools](https://docs.xbox.com/ko/tools/tools-pc/xbox-pc-remote-tools/index.md)
- [Windows PC의 Fiddler](https://docs.xbox.com/ko/build/console-features/networking/tools/fiddler-pc.md)
