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

# Procédure pas à pas : déployer des builds à l'aide de PowerShell/de l'API

> Procédure pas à pas de déploiement de builds PlayFab Multiplayer Servers pour le système d'exploitation Windows à l'aide de PowerShell et de l'API Multiplayer Servers, avec l'exemple Windows Runner C#.

Cette rubrique explique comment déployer ou créer des builds de machines virtuelles sous système d'exploitation Windows dans PowerShell, sur un appareil de développement Windows 10, à partir de l'exemple Windows Runner C#.

<Note>
  Pour utiliser et afficher PlayFab Multiplayer Servers, vous devez activer la fonctionnalité. Nous vous recommandons d'utiliser la méthode Game Manager pour activer cette fonctionnalité. Pour obtenir des instructions, consultez [Activer la fonctionnalité PlayFab Server](/fr/services/playfab/multiplayer/servers/enable-playfab-multiplayer-servers).
</Note>

## Prérequis

Assurez-vous d'avoir effectué les étapes suivantes.

* [Configurer l'option des fonctionnalités d'API](/fr/services/playfab/multiplayer/servers/windows-runner-sample#configure-api-feature-option)
* [Configuration du serveur](/fr/services/playfab/multiplayer/servers/windows-runner-sample#server-set-up).

## 1. Obtenir l'ID de votre titre et la clé secrète de développeur

* Obtenez l'ID de votre titre PlayFab
  * Connectez-vous à votre compte de développeur sur [PlayFab.com](https://developer.playfab.com)
  * Dans Game Manager, accédez à la page **My Studios and Titles**. Recherchez votre titre de jeu et récupérez l'ID de titre de jeu PlayFab

* Obtenez la clé secrète de développeur du titre
  * Dans Game Manager, sélectionnez votre titre > paramètres (icône d'engrenage)
  * Sélectionnez **Title settings**, puis l'onglet **Secret Keys** pour obtenir la clé secrète de développeur

Pour plus d'informations sur les clés secrètes, consultez [Gestion des clés secrètes](/fr/services/playfab/live-service-management/gamemanager/secret-key-management)

## 2. Installer le module PowerShell PlayFab Multiplayer

Ouvrez Windows PowerShell en tant qu'administrateur et exécutez la commande suivante pour installer le [module PlayFabMultiplayer API](https://github.com/PlayFab/MpsPowershell). Ce nouveau [module PlayFabMultiplayer API](https://github.com/PlayFab/MpsPowershell) remplace le module Multiplayer PowerShell déprécié.

Si vous avez déjà installé le module [PlayFab Multiplayer Powershell](https://github.com/PlayFab/MultiplayerPowershell), désinstallez-le à l'aide de la commande suivante. Si vous passez au nouveau module, consultez [Mappage des commandes](/fr/services/playfab/multiplayer/servers/deploy-using-powershell-api#mapping-commands) pour trouver les nouvelles commandes équivalentes.

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

Les commandes et les arguments sont différents dans ce nouveau module. Pour obtenir une documentation détaillée sur chaque commande, consultez la [documentation des cmdlets](https://github.com/PlayFab/MpsPowershell/tree/main/MpsPowershell/docs).

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

<Tip>
  Avant d'installer le module, vous devrez peut-être d'abord définir votre stratégie d'exécution à l'aide de `Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope CurrentUser`. Pour en savoir plus, consultez [Stratégies d'exécution PowerShell](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies).
</Tip>

## 3. Obtenir un EntityToken pour votre titre

Dans la fenêtre **PowerShell**, exécutez la commande suivante avec l'ID de votre titre et la clé de développeur associée :

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

## 4. Charger des ressources

Lorsque vous déployez des serveurs Windows, vous utilisez le conteneur Windows managé. Il vous suffit de charger la build de serveur de jeu multijoueur PlayFab en tant que ressource.

Mettez à jour la valeur de l'indicateur **FilePath** avec l'emplacement local du fichier **winrunnerSample.zip**. Si vous ne savez pas où se trouve ce fichier, suivez les instructions [ici](/fr/services/playfab/multiplayer/servers/windows-runner-sample#server-set-up) pour l'obtenir.

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

## 5. Créer une build

Maintenant que la ressource est chargée, nous pouvons créer une build. Exécutez les commandes suivantes.

Le code ci-dessous utilise la machine virtuelle **Standard\_D2as\_v4** dans la région **EastUS**. Remplacez les chaînes en fonction de la machine virtuelle et de la région que vous souhaitez utiliser.

```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
```

## Vérifier que votre build a réussi

Au bout de quelques secondes, vous devriez voir la build créée via **PowerShell** ou l'[API ListBuildSummaries](xref:titleid.playfabapi.com.multiplayer.multiplayerserver.listbuildsummariesv2).

Vous pouvez également exécuter la commande suivante pour vérifier que la build a été déployée correctement.

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

## Voir aussi

* [Procédure pas à pas : déployer des builds à l'aide de Game Manager](/fr/services/playfab/multiplayer/servers/quickstart-for-multiplayer-servers-game-manager)
* [Exemple Windows Runner C#](/fr/services/playfab/multiplayer/servers/windows-runner-sample)
* [Exemples et ressources](/fr/services/playfab/multiplayer/servers/server-samples-resources)


## Related topics

- [Déployer des builds à l'aide de PowerShell/de l'API](/fr/services/playfab/multiplayer/servers/deploy-using-powershell-api.md)
- [Attacher un profileur](/fr/services/playfab/multiplayer/servers/attaching-a-profiler.md)
- [Procédure pas à pas : déployer des builds à l'aide de Game Manager](/fr/services/playfab/multiplayer/servers/quickstart-for-multiplayer-servers-game-manager.md)
- [Déployer des builds à l'aide de Game Manager](/fr/services/playfab/multiplayer/servers/deploy-using-game-manager.md)
- [Déploiement des builds PlayFab Multiplayer Server](/fr/services/playfab/multiplayer/servers/deploying-playfab-multiplayer-server-builds.md)