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

# XBOX PC Remote Tools 빠른 시작 가이드

> XBOX PC Toolbox 앱을 설치하고 개발 PC 및 대상 디바이스를 구성합니다.

# XBOX PC Remote Tools 빠른 시작 가이드

<Info>
  XBOX PC Toolbox 앱은 미리 보기 상태입니다. Windows의 [Microsoft Store](https://aka.ms/toolboxinstaller)에서 다운로드하세요.
</Info>

## 이전 미리 보기 버전 정리

<Note>
  이전 미리 보기에 참여하지 않은 경우 이 섹션을 건너뛰세요. 그렇지 않으면 다음 정리 단계를 따르세요.
</Note>

### PowerShell 스크립트 사용

1. 두 디바이스에 [정리 스크립트](https://aka.ms/CleanupScript)를 다운로드합니다.

2. 개발 PC에서:
   * 관리자로 PowerShell 또는 PowerShell 7을 엽니다.
   * 다운로드한 위치로 이동합니다(예: `cd downloads`).
   * 다음 명령을 실행합니다.

```powershell theme={null}
      pwsh Remove-XboxPCDeviceArtifacts.ps1 -Target devpc
```

1. 대상 디바이스에서:
   * USB 스틱이나 근처 공유를 사용하여 스크립트를 대상 디바이스에 복사합니다.
   * 관리자로 PowerShell 또는 PowerShell 7을 엽니다.
   * 다운로드한 위치로 이동합니다(예: `cd downloads`).
   * 다음 명령을 실행합니다.

```powershell theme={null}
pwsh Remove-XboxPCDeviceArtifacts.ps1 -Target targetdevice
```

## 설치 및 설정

### 사전 요구 사항

* 설정 중에 두 디바이스 모두 인터넷 액세스가 필요합니다.
* 두 디바이스에 Microsoft Store에서 XBOX PC Toolbox 앱을 설치합니다.
* 디바이스는 동일한 로컬 네트워크를 공유하고 서로 핑할 수 있어야 합니다.
* RETAIL 샌드박스에서 XBOX PC Toolbox 애플리케이션을 가져옵니다. 설정 후에는 모든 개발자 샌드박스로 전환할 수 있습니다.
* Windows 10 또는 Windows 11 Home 또는 Pro 에디션만 지원됩니다.
* 설정 중에 두 디바이스에 물리적으로 액세스해야 합니다.
* Microsoft Entra ID에 조인된 대상 디바이스는 경량 프로비저닝을 통해서만 지원됩니다. 완전 관리형은 Entra에 조인된 디바이스에서 사용할 수 없습니다. 앱은 이 조건을 자동으로 감지하고 설정 중에 완전 관리형 옵션을 비활성화합니다.
* 두 디바이스에서 관리자 액세스가 필요합니다.

### XBOX PC Toolbox 설정으로 수행되는 변경 사항

#### 개발 PC 구성 변경 사항

* 개발자 모드를 활성화합니다.
* 문서 폴더에 PowerShell 모듈을 설치합니다.
* 네트워크 어댑터의 프로필을 개인용으로 설정합니다.
* 개인 네트워크에서 파일 및 프린터 공유와 네트워크 검색을 활성화합니다.
* Windows Remote Management (WinRM)를 활성화합니다.
* OpenSSH Client를 설치하고 `ssh-agent`가 자동으로 시작되도록 구성합니다.
* 사용할 SSH 키를 만듭니다.

#### 설정 중 대상 디바이스에 적용되는 구성 변경 사항

* 개발자 모드를 활성화합니다.
* 문서 폴더에 PowerShell 모듈을 설치합니다.
* 네트워크 어댑터의 프로필을 개인용으로 설정합니다.
* 개인 네트워크에서 파일 및 프린터 공유와 네트워크 검색을 활성화합니다.
* WinRM을 활성화합니다.
* OpenSSH Server를 설치하고 `sshd`가 자동으로 시작되도록 구성합니다.
* 포트 22에서 SSH 서버에 대한 방화벽 규칙을 추가합니다.
* 절전 및 디스플레이 시간 제한을 제거합니다.
* PowerShell 하위 시스템 및 키 기반 인증에 대한 SSH를 구성합니다.
* Visual C++ Runtime Redistributable을 설치합니다.
* `wdEndpoint`가 들어오는 연결을 수신할 수 있도록 포트 4275에서 netsh HTTPS 규칙을 설정합니다.

알려진 문제 및 자주 묻는 질문은 [XBOX PC Remote Tools FAQ 가이드](/tools/tools-pc/xbox-pc-remote-tools/faq)를 참조하세요.

## API 참조

<Card title="XBOX PC Remote Iteration API 참조" icon="code" href="/reference/remoting/remoteiteration_members">
  XBOX PC Remote Iteration API를 사용하여 원격 배포, 실행 및 프로세스 관리를 자동화합니다.
</Card>


## Related topics

- [XBOX PC Remote Tools FAQ 및 문제 해결 가이드](/ko/tools/tools-pc/xbox-pc-remote-tools/faq.md)
- [XBOX PC Remote Tools: 2026년 3월 (2603) 릴리스 노트](/ko/tools/tools-pc/xbox-pc-remote-tools/release-notes/2603.md)
- [XBOX PC Remote Tools 사용 방법](/ko/tools/tools-pc/xbox-pc-remote-tools/how-to-use-tools.md)
- [Visual Studio에서 원격 Windows 디바이스의 PC 프로젝트 디버깅하기](/ko/tools/tools-pc/visualstudio/gr-vs-debugging-with-visualstudio-remote-windows.md)
- [Azure Functions를 사용하는 PlayFab CloudScript 빠른 시작 가이드](/ko/services/playfab/live-service-management/service-gateway/automation/cloudscript-af/quickstart.md)