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

# Passo a passo: implantar builds usando PowerShell/API

> Passo a passo para implantar builds do PlayFab Multiplayer Servers para o sistema operacional Windows usando o PowerShell e a API do Multiplayer Servers com o exemplo C# Windows Runner.

Este tópico descreve como implantar/criar builds para VMs com sistema operacional Windows no PowerShell, em um dispositivo de desenvolvimento com Windows 10, com base no exemplo C# Windows Runner.

<Note>
  Para usar e ver o PlayFab Multiplayer Servers, você precisa habilitar o recurso. Recomendamos usar o método do Game Manager para habilitar esse recurso. Para obter instruções, consulte [Habilitar o recurso PlayFab Server](/pt-BR/services/playfab/multiplayer/servers/enable-playfab-multiplayer-servers).
</Note>

## Pré-requisitos

Verifique se você concluiu as etapas a seguir.

* [Configurar a opção de recurso de API](/pt-BR/services/playfab/multiplayer/servers/windows-runner-sample#configure-api-feature-option)
* [Configuração do servidor](/pt-BR/services/playfab/multiplayer/servers/windows-runner-sample#server-set-up).

## 1. Obter a ID do título e a chave secreta de desenvolvedor

* Obtenha a ID do título do PlayFab
  * Faça logon na sua conta de desenvolvedor em [PlayFab.com](https://developer.playfab.com)
  * No Game Manager, vá para a página **My Studios and Titles**. Procure o título do seu jogo e obtenha a ID do título do jogo no PlayFab

* Obtenha a chave secreta de desenvolvedor do título
  * No Game Manager, selecione seu título > configurações (ícone de engrenagem)
  * Selecione **Title settings** e, em seguida, a guia **Secret Keys** para obter a chave secreta de desenvolvedor

Para obter mais informações sobre chaves secretas, consulte [Gerenciamento de chaves secretas](/pt-BR/services/playfab/live-service-management/gamemanager/secret-key-management)

## 2. Instalar o módulo PlayFab Multiplayer PowerShell

Abra o Windows Powershell como Administrador e execute o comando a seguir para instalar o [módulo PlayFabMultiplayer API](https://github.com/PlayFab/MpsPowershell). Esse novo [módulo PlayFabMultiplayer API](https://github.com/PlayFab/MpsPowershell) substitui o módulo Multiplayer PowerShell preterido.

Se você instalou anteriormente o módulo [PlayFab Multiplayer Powershell](https://github.com/PlayFab/MultiplayerPowershell), desinstale-o com o comando a seguir. Para quem está fazendo a transição para o novo módulo, consulte [Mapeamento de comandos](/pt-BR/services/playfab/multiplayer/servers/deploy-using-powershell-api#mapping-commands) para encontrar os novos comandos equivalentes.

```powershell theme={null}
Uninstall-Package PlayFabMultiplayer
```

Tanto os comandos quanto os argumentos são diferentes neste novo módulo. Para obter a documentação detalhada sobre cada comando, consulte a [documentação dos cmdlets](https://github.com/PlayFab/MpsPowershell/tree/main/MpsPowershell/docs).

```powershell theme={null}
Install-Module -Name PlayFabMultiplayerApi
```

<Tip>
  Antes de instalar o módulo, talvez seja necessário definir primeiro sua política de execução usando `Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope CurrentUser`. Para saber mais, consulte [Políticas de execução do PowerShell](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies).
</Tip>

## 3. Obter um EntityToken para o seu título

Na janela do **PowerShell**, execute o seguinte comando usando a ID do título e a chave de desenvolvedor associada:

```powershell theme={null}
Set-PfTitle -TitleID "mytitleID" -SecretKey "mysecretkey"
```

## 4. Carregar ativos

Ao implantar servidores Windows, você usará o contêiner Windows gerenciado. Basta carregar o PlayFab Multiplayer Game Server Build como um ativo.

Atualize o valor do sinalizador **FilePath** com o local do arquivo local **winrunnerSample.zip**. Se não souber onde está esse arquivo, siga as instruções [aqui](/pt-BR/services/playfab/multiplayer/servers/windows-runner-sample#server-set-up) para obtê-lo.

```powershell theme={null}
New-PfAsset -FilePath C:\windowsRunnerCSharp.zip -AssetName windowsRunnerCSharp.zip
```

## 5. Criar um build

Agora que o ativo foi carregado, podemos criar um build. Execute os comandos a seguir.

O código abaixo usa a VM **Standard\_D2as\_v4** na região **EastUS**. Substitua as cadeias de caracteres de acordo com a VM e a região que você deseja usar.

```powershell theme={null}
$vmSize = "Standard_D2as_v4"

$regions = @( @{ StandbyServers = 1; MaxServers = 1; Region = 'EastUS'; ScheduledStandbySettings = $NULL } )

$ports = @( @{ Name = 'game_port'; Num = 3600; Protocol = 'TCP' } )

$gameAssets = @( @{ FileName = 'windowsRunnerCSharp.zip'; MountPath = 'C:\Assets' } )

$buildResponse = New-PfBuild -BuildName PSTest_build -ContainerFlavor ManagedWindowsServerCore -StartMultiplayerServerCommand 'C:\Assets\WindowsRunnerCSharp.exe' -GameAssetReferences $gameAssets -VMSize $vmSize -MultiplayerServerCountPerVM 1 -Ports $ports -RegionConfigurations $regions

# All PlayFabMultiplayerApi cmdlets return objects, so we can pass the returned object to ConvertTo-Json for human readability.
$buildResponse | ConvertTo-Json -depth 5
```

## Verificar se o build foi bem-sucedido

Em alguns segundos, você verá o build criado pelo **PowerShell** ou pela [API ListBuildSummaries](xref:titleid.playfabapi.com.multiplayer.multiplayerserver.listbuildsummariesv2).

Você também pode executar o comando a seguir para verificar se o build foi implantado com êxito.

```powershell theme={null}
Get-PfBuild | ConvertTo-Json -depth 5
```

## Confira também

* [Passo a passo: implantar builds usando o Game Manager](/pt-BR/services/playfab/multiplayer/servers/quickstart-for-multiplayer-servers-game-manager)
* [Exemplo C# Windows Runner](/pt-BR/services/playfab/multiplayer/servers/windows-runner-sample)
* [Exemplos e recursos](/pt-BR/services/playfab/multiplayer/servers/server-samples-resources)


## Related topics

- [Implantar builds usando PowerShell/API](/pt-BR/services/playfab/multiplayer/servers/deploy-using-powershell-api.md)
- [Anexando um criador de perfil](/pt-BR/services/playfab/multiplayer/servers/attaching-a-profiler.md)
- [Passo a passo: implantar builds usando o Game Manager](/pt-BR/services/playfab/multiplayer/servers/quickstart-for-multiplayer-servers-game-manager.md)
- [Implantar builds usando o Game Manager](/pt-BR/services/playfab/multiplayer/servers/deploy-using-game-manager.md)
- [Implantando builds do PlayFab Multiplayer Server](/pt-BR/services/playfab/multiplayer/servers/deploying-playfab-multiplayer-server-builds.md)