​

XBOX PC Remote Tools 빠른 시작 가이드

​

이전 미리 보기 버전 정리

​

PowerShell 스크립트 사용

1. 두 디바이스에 정리 스크립트를 다운로드합니다.
2. 개발 PC에서:
   • 관리자로 PowerShell 또는 PowerShell 7을 엽니다.
   • 다운로드한 위치로 이동합니다(예: cd downloads).
   • 다음 명령을 실행합니다.

      pwsh Remove-XboxPCDeviceArtifacts.ps1 -Target devpc

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

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 규칙을 설정합니다.

​

API 참조