Skip to main content
이 문서에서는 Windows 10 개발 장치에서 PowerShell을 사용하여 Windows OS의 VM용 빌드를 배포/생성하는 방법을 개괄적으로 설명합니다. PowerShell/API를 사용하여 빌드를 배포할 때는 Game Manager와 API를 함께 사용하게 될 가능성이 큽니다. 따라서 PowerShell/API 명령은 아래에 기능별로 나열되어 있습니다. 빌드를 처음 배포하는 경우 실제로 서버를 배포하는 데 필요한 모든 자산을 제공하는 Wrapper 샘플을 사용하여 빌드를 배포하는 것을 권장합니다.
PlayFab Multiplayer Servers를 사용하고 보려면 이 기능을 활성화해야 합니다. 새 사용자인 경우, Game Manager 방법을 사용하여 이 기능을 활성화하는 것이 좋습니다. 지침은 PlayFab 서버 기능 활성화를 참조하세요.

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

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

PlayFab MultiplayerAPI PowerShell 모듈 설치

  1. 관리자 권한으로 Windows PowerShell을 엽니다.
  2. PlayFab Multiplayer PowerShell 모듈을 이전에 설치한 경우, 다음 명령을 사용하여 제거합니다. 이 모듈은 이제 더 이상 사용되지 않습니다.
새 모듈로 전환하는 데 도움이 되도록 명령 매핑을 참조하여 새로운 동등 명령을 찾으세요. 명령과 인수 모두 다를 수 있음에 유의하세요.
  1. PlayFabMultiplayer API 모듈을 설치합니다.
각 명령에 대한 자세한 문서는 Cmdlet 문서를 참조하세요.
모듈을 설치하기 전에 먼저 PowerShell에서 Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope CurrentUser를 실행하여 실행 정책을 설정해야 할 수도 있습니다. 자세한 내용은 PowerShell 실행 정책을 참조하세요.
  1. 다음 명령을 실행하여 PlayFab Multiplayer PowerShell 모듈의 cmdlet에 대해 자세히 알아보세요. 또는 PlayFabMultiplayerApi cmdlet 참조 문서를 참조할 수도 있습니다.

타이틀용 EntityToken 획득

타이틀 ID와 연결된 개발자 키를 사용하여 다음 명령을 실행합니다. PlayFabMultiplayerApi PowerShell 모듈을 사용할 때 세션 시작 시 이 명령을 실행해야 합니다. 이는 GetEntityToken API를 호출하여 EntityToken을 획득하고 향후 cmdlet에서 사용할 수 있도록 환경 변수에 저장합니다.

타이틀에 대해 멀티플레이어 서버 기능 활성화

아래 cmdlet을 실행하여 Multiplayer Servers 기능을 활성화합니다. 이는 enable multiplayer servers API를 호출합니다.
Title must have a valid payment instrument associated with it in order to enable Multiplayer Servers라는 오류가 표시되는 경우, Game Manager를 사용하여 결제 정보를 추가하려면 PlayFab Multiplayer Servers 활성화를 참조하세요.

자산 업로드

Windows 서버용 빌드를 배포할 때는 자산 업로드가 필수입니다. 이는 자산이 관리형 Windows 컨테이너 이미지를 사용자 지정하기 때문입니다. 그러나 Linux 서버용 빌드를 배포할 때는 Linux 컨테이너 이미지를 사용자 지정할 수 있으므로 선택 사항입니다. 자세한 내용은 Linux 빌드 생성 및 배포를 참조하세요. 자산을 업로드하려면 이 명령을 실행합니다.
여기서:
  • Filepath: 업로드할 로컬 파일의 경로
  • AssetName: 업로드할 자산의 이름
자세한 내용은 New-PfAsset 참조 문서를 참조하세요.

빌드 생성

  • Windows 서버용 빌드를 생성할 때 자산을 업로드해야 합니다. 그렇지 않은 경우 자산 업로드를 참조하세요.
  • Linux 서버용 빌드를 생성할 때는 PlayFab 컨테이너 레지스트리에 사용자 지정 Linux 컨테이너 이미지를 업로드해야 합니다. 자세한 내용은 Linux 빌드 생성 및 배포를 참조하세요.
무료 평가판에서 제공되는 리소스를 활용하려는 경우 __vmSize__와 __regions__에 올바른 값을 사용하세요.
Windows 게임 서버용 빌드를 배포하는 데 도움이 되는 샘플 코드는 다음과 같습니다.
Linux 게임 서버용 빌드를 배포하는 데 도움이 되는 샘플 코드는 다음과 같습니다.
개발 중에는 VM 코어 사용 시간을 피하기 위해 사용하지 않거나 상태가 좋지 않은 지역을 종료하세요. 코어 사용 시간은 VM 시작 중에 시작되어 VM이 종료될 때까지 계속됩니다. 지역의 대상 대기 서버가 0에 도달하거나 지역이 삭제되지 않는 한 지역의 VM은 자동으로 종료되지 않습니다.

VM 종료

VM을 종료하는 세 가지 방법이 있습니다.
  1. 지역의 target standby를 0으로 설정하면 해당 지역의 VM만 종료됩니다.
  2. 빌드에서 특정 지역을 삭제합니다.
  3. 전체 빌드를 삭제하면 이 빌드의 모든 지역에서 VM이 종료됩니다.

배포된 빌드 나열

타이틀의 빌드 목록을 보려면 아래 명령을 실행합니다.

멀티플레이어 서버 요청

빌드를 생성하면 .exe 파일을 실행한 후 하나 이상의 서버가 생성됩니다. 이러한 서버는 이제 “대기 중” 상태가 됩니다. 이 명령을 사용하여 빌드가 실행 중인 모든 서버를 나열할 때 확인할 수 있습니다.
일부 대기 서버가 확인되면 게임 플레이용으로 하나를 요청해 보겠습니다…
해당 호출에 대한 응답에는 클라이언트가 연결할 수 있는 IPv4 주소와 포트 번호가 포함됩니다. WindowsRunnerCSharp.exe의 경우 간단한 웹 서버를 호스팅하므로 IPv4 주소와 포트 번호로 이동하여 응답을 받을 수 있습니다.
이는 PlayFab 멀티플레이어 서버의 핵심입니다. 매치메이킹 서비스가 RequestMultiplayerServer를 호출한 후 3초 이내에 PlayFab이 새 서버를 할당합니다. 이러한 서버는 지역별, 빌드별로 구성된 지속적으로 다시 채워지는 대기 서버 풀에서 제공됩니다.

명령 매핑

아래 표는 이전 명령의 새로운 동등 명령을 보여줍니다. 이는 이전 버전의 PowerShell 모듈을 사용했으며 기존 명령을 변환해야 하는 사용자를 돕기 위한 빠른 매핑입니다. 일부 인수도 변경되었으므로 변경 사항의 전체 세부 정보를 얻으려면 각 명령의 정의를 반드시 읽으세요.

관련 항목

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