Skip to main content
이 문서에서는 Windows Runner C# 샘플을 기반으로 Windows 10 개발 장치의 PowerShell에서 Windows OS VM용 빌드를 배포/생성하는 방법을 설명합니다.
PlayFab Multiplayer Servers를 사용하고 보려면 기능을 활성화해야 합니다. Game Manager 방법을 사용하여 이 기능을 활성화하는 것이 좋습니다. 지침은 PlayFab Server 기능 활성화를 참조하세요.

사전 요구 사항

다음 단계를 완료했는지 확인하세요.

1. 타이틀 ID 및 개발자 비밀 키 가져오기

  • PlayFab 타이틀 ID 가져오기
    • PlayFab.com에서 개발자 계정에 로그인합니다.
    • Game Manager에서 My Studios and Titles 페이지로 이동합니다. 게임 타이틀을 찾아 PlayFab 게임 타이틀 ID를 가져옵니다.
  • 타이틀의 개발자 비밀 키 가져오기
    • Game Manager에서 타이틀 > 설정(톱니바퀴 아이콘)을 선택합니다.
    • Title settings를 선택한 다음 Secret Keys 탭을 선택하여 개발자 비밀 키를 가져옵니다.
비밀 키에 대한 자세한 내용은 비밀 키 관리를 참조하세요.

2. PlayFab Multiplayer PowerShell 모듈 설치

Windows PowerShell을 관리자 권한으로 열고 다음 명령을 실행하여 PlayFabMultiplayer API 모듈을 설치합니다. 이 새로운 PlayFabMultiplayer API 모듈은 더 이상 사용되지 않는 Multiplayer PowerShell 모듈을 대체합니다. 이전에 PlayFab Multiplayer Powershell 모듈을 설치한 경우 다음 명령으로 제거하세요. 새 모듈로 전환하려는 경우 명령 매핑을 참조하여 새로운 동등한 명령을 찾으세요.
이 새 모듈에서는 명령과 인수가 모두 다릅니다. 각 명령에 대한 자세한 문서는 Cmdlet 문서를 참조하세요.
모듈을 설치하기 전에 먼저 Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope CurrentUser를 사용하여 실행 정책을 설정해야 할 수도 있습니다. 자세한 내용은 PowerShell 실행 정책을 참조하세요.

3. 타이틀에 대한 EntityToken 획득

PowerShell 창에서 타이틀 ID 및 관련 개발자 키를 사용하여 다음 명령을 실행합니다.

4. 자산 업로드

Windows 서버를 배포할 때는 관리형 Windows 컨테이너를 사용합니다. PlayFab Multiplayer Game Server Build를 자산으로 업로드하기만 하면 됩니다. FilePath 플래그의 값을 __winrunnerSample.zip__의 로컬 파일 위치로 업데이트하세요. 이 파일의 위치를 모른다면 여기의 지침에 따라 파일을 가져오세요.

5. 빌드 생성

이제 자산이 업로드되었으므로 빌드를 생성할 수 있습니다. 다음 명령을 실행합니다. 아래 코드는 EastUS 지역의 Standard_D2as_v4 VM을 사용합니다. 사용하려는 VM 및 지역에 따라 문자열을 바꾸세요.

빌드가 성공했는지 확인

몇 초 후에 PowerShell 또는 ListBuildSummaries API를 통해 빌드가 생성된 것을 볼 수 있습니다. 다음 명령을 실행하여 빌드가 성공적으로 배포되었는지 확인할 수도 있습니다.

참고 항목

마지막 수정일 2026년 8월 25일