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

# PC 샌드박스 전환기 (XblPCSandbox.exe)

> Microsoft Store 및 XBOX App을 포함해 XBOX 서비스 샌드박스에서 PC 앱을 표시, 전환, 다시 실행하는 명령줄 XblPCSandbox.exe 도구입니다.

XblPCSandbox.exe는 PC에서 XBOX services 샌드박스를 관리하는 명령줄 도구입니다. 다음 용도로 사용하세요.

* 현재 샌드박스를 표시합니다.
* 개발 샌드박스로 전환하거나 RETAIL로 되돌립니다.
* 시스템 앱(Microsoft Store 및 XBOX App)을 샌드박스 모드로 다시 시작합니다.

## 시작하기

Microsoft Game Development Kit (GDK)를 설치한 후 GDK 명령 프롬프트를 열고 거기서 도구를 실행하세요. 다음 작업을 수행하여 GDK 명령 프롬프트를 찾을 수 있습니다.

1. **시작** 메뉴를 열고 **Microsoft GDK Command Prompts**를 검색합니다.
2. **Microsoft GDK Command Prompts** 폴더에서 바로 가기를 엽니다(설치된 최신 GDK 버전을 선택).

이 도구는 GDK 및 `XboxLiveTools.zip`의 일부로도 제공됩니다. [XBOX services용 개발 도구](/tools/tools-services/live-tools)를 참조하세요.

<Info>샌드박스 설정에는 **상승된 권한**(관리자 권한으로 실행)이 필요합니다. 상승된 권한 없이 도구를 실행하면 상승된 상태로 다시 실행을 시도합니다. 샌드박스 읽기(`/get`) 및 도움말 표시(`/?`)는 권한 상승이 필요하지 않습니다.</Info>

## 명령 및 옵션 참조

```cmd theme={null}
Usage: XblPCSandbox [command] [options]
```

| 명령                  | 설명                                                                                                                                                                                            |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `/get`              | 현재 샌드박스를 표시합니다. 샌드박스가 설정되어 있지 않으면 디바이스는 RETAIL 상태입니다.                                                                                                                                         |
| `/set <sandbox ID>` | 샌드박스를 설정합니다(예: `XDKS.1`). XBOX Live Auth Manager를 다시 시작하고 **열려 있는** 모든 시스템 앱을 샌드박스 모드로 다시 시작합니다. 샌드박스를 RETAIL로 되돌리려면 샌드박스 이름으로 'RETAIL'을 사용하거나 아래에 설명된 동등한 /retail 옵션을 사용하세요. /noApps를 지원합니다. |
| `/launchApps`       | Microsoft Store 및 XBOX App을 샌드박스 모드로 다시 시작합니다. 이미 열려 있는 경우에만 해당됩니다. `/noApps` 전환 후에 유용합니다.                                                                                                    |
| `/retail`           | `XblPCSandbox RETAIL`과 동일합니다. 디바이스를 기본 소비자 샌드박스로 재설정하는 편의 스위치입니다.                                                                                                                             |
| `/feedback`         | 피드백 허브를 열어 샌드박스 전환 경험에 대한 문제를 신고하거나 피드백을 제공할 수 있습니다.                                                                                                                                          |

| 옵션         | 설명                                                                                              |
| ---------- | ----------------------------------------------------------------------------------------------- |
| `/?`       | 문제 해결 팁 및 문제 해결 문서 링크를 포함하여 사용 가능한 모든 명령과 옵션에 대한 도움말 정보를 표시합니다.                                 |
| `/help`    | `/?`와 동일합니다.                                                                                    |
| `/noApps`  | 시스템 앱을 다시 시작하지 **않고** 샌드박스를 설정합니다. 준비되면 나중에 `xblPCSandbox /launchApps`를 사용하여 샌드박스 모드로 다시 시작하세요. |
| `/version` | xblPCSandbox 명령줄 도구의 버전 정보를 표시합니다.                                                              |

## 현재 샌드박스 가져오기

```cmd theme={null}
XblPCSandbox /get
```

현재 XBOX services 샌드박스를 표시합니다. 샌드박스가 설정되어 있지 않으면 디바이스는 **RETAIL** 상태입니다.

## 샌드박스 설정

```cmd theme={null}
XblPCSandbox /set <sandbox ID>
```

디바이스에 XBOX services 샌드박스를 설정합니다. 예: `XblPCSandbox /set XDKS.1`

샌드박스를 설정할 때 이 도구는:

1. 전환 전에 **현재 샌드박스**를 표시합니다.
2. 전환이 진행되는 동안 **진행 스피너**를 표시합니다.
3. **XBOX Live Auth Manager** 서비스를 다시 시작합니다.
4. 다음 **시스템 앱**을 샌드박스 모드로 다시 시작합니다. 이미 열려 있는 경우에만 해당됩니다.
   * Microsoft Store
   * XBOX App
5. 전환 후 **새 샌드박스**를 표시하여 즉시 적용되었는지 확인할 수 있게 합니다.

전환 시점에 시스템 앱이 **열려 있지 않으면** 자동으로 시작되지 **않습니다**.

<Note>이 도구는 샌드박스 이름의 대소문자를 자동으로 수정합니다. 예를 들어 `xdks.1`을 입력하면 `XDKS.1`로 수정됩니다.
샌드박스 이름은 대문자로 되어 있으므로 대소문자 구분으로 인한 오류를 줄여줍니다.</Note>

### 앱을 다시 시작하지 않고 샌드박스 설정

```cmd theme={null}
XblPCSandbox /set <sandbox ID> /noApps
```

시스템 앱을 다시 시작하지 않고 샌드박스를 설정합니다. 나중에 다음을 사용하여 다시 시작할 수 있습니다.

```cmd theme={null}
XblPCSandbox /apps
```

## RETAIL로 되돌리기

```cmd theme={null}
XblPCSandbox /retail
```

또는

```cmd theme={null}
XblPCSandbox /set RETAIL
```

디바이스를 기본 소비자 샌드박스로 재설정합니다. XBOX Live Auth Manager를 다시 시작하고 열려 있는 모든 시스템 앱(Microsoft Store 및 XBOX App)을 정상 모드로 다시 시작합니다.

<Tip>Microsoft Store에서 XBOX App 또는 Gaming Services를 업데이트하려면 RETAIL로 되돌려야 합니다. 개발 샌드박스에 있는 동안에는 이러한 앱이 업데이트를 받을 수 없습니다.</Tip>

## 샌드박스 모드에서 시스템 앱 시작

```cmd theme={null}
XblPCSandbox /apps
```

이미 열려 있는 경우에만 Microsoft Store 및 XBOX App을 샌드박스 모드로 다시 시작합니다. `/noApps` 옵션으로 샌드박스를 전환한 후 유용합니다.

## 도움말 표시

```cmd theme={null}
XblPCSandbox /?
```

사용 가능한 모든 명령 및 옵션에 대한 도움말 정보를 표시합니다. 도움말 텍스트에는 문제 해결 제안 및 [로그인 및 샌드박스 오류 문제 해결](/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes) 문서에 대한 링크도 포함됩니다.

## 피드백 제공

```cmd theme={null}
XblPCSandbox /feedback
```

피드백 허브를 직접 열어 샌드박스 전환 경험에 대한 문제를 신고하거나 피드백을 제공할 수 있습니다.

## 함께 보기

* [샌드박스 개요](/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox)
* [고급 샌드박스 개요](/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes)
* [로그인 및 샌드박스 오류 문제 해결](/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes)
* [테스트 계정](/services/xbox-services/develop/test-accounts/live-test-accounts)
* [XBOX services용 개발 도구](/tools/tools-services/live-tools)


## Related topics

- [XBOX 서비스용 개발 도구](/ko/tools/tools-services/live-tools.md)
- [XBOX 서비스용 도구](/ko/tools/tools-services/live-tools-nav.md)
- [XBOX services 샌드박스 개요](/ko/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md)
- [PC의 XStore — DRM, 라이선스 토큰, 샌드박스](/ko/publishing/xstore-commerce/xstore-pc.md)
- [XBOX PC Remote Tools FAQ 및 문제 해결 가이드](/ko/tools/tools-pc/xbox-pc-remote-tools/faq.md)