> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/rdm/fr/knowledge-base/how-to-articles/configure-laps-with-a-custom-credentials-entry.md).

# Configurer LAPS avec une entrée d'identifiants personnalisée

Le guide suivant décrit comment ajouter un script PowerShell dans une entrée d'identifiants personnalisée afin de se connecter à une machine distante en utilisant [Windows LAPS](https://learn.microsoft.com/en-us/windows-server/identity/laps/laps-overview). Windows LAPS est requis et doit être correctement configuré dans votre environnement pour utiliser cette solution.

{% hint style="success" %}
À partir de Remote Desktop Manager v.2024.3, les entrées d'identifiants LAPS sont des entrées officielles et n'ont plus besoin d'être personnalisées. Le paramètre ***Nom d'utilisateur*** de l'hôte doit tout de même être changé pour l'hôte distant, sinon l'authentification utilisera l'hôte local par défaut. Pour effectuer ce changement, entrez $HOST$\username (*username*signifie le nom d'utilisateur de l'hôte distant), dans le champ ***Général*** – ***Hôte*** - ***Nom d'utilisateur***.
{% endhint %}

1\. Dans Remote Desktop Manager Windows, créez une nouvelle entrée dans le ruban sous l'onglet ***Édition***. 2. Dans ***Gestion des identifiants***, sélectionnez le type d'entrée ***Personnalisé***.

![](https://cdnweb.devolutions.net/docs/docs_en_kb_KB2334.png)

3. Nommez votre entrée et sélectionnez son dossier de destination.
4. Dans l'onglet ***Général***, assurez-vous que le menu déroulant est défini à ***PowerShell***.

   ![](https://cdnweb.devolutions.net/docs/docs_en_kb_KB2335.png)
5. Ajoutez le script PowerShell suivant dans la boîte ***Commande***.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Le script utilise la variable <code>$HOST$</code> pour le commutateur <code>-ComputerName</code> de l'applet de commande <code>Get-LapsADPassword</code> et utilise la variable <code>$PARAMETER1$</code> pour le nom d'utilisateur (voir l'étape 6 ci-dessous). Selon votre environnement, le <code>$PARAMETER$</code> pourrait être lié à <code>-Identity</code>. Vous pouvez aussi configurer le <em><strong>Paramètre #2</strong></em> pour définir le nom d'utilisateur dont vous avez besoin et changer la valeur du script de <code>%USERNAME%</code> à <code>$PARAMETER2$</code>. Nous recommandons de lancer Remote Desktop Manager en tant qu'administrateur pour obtenir des permissions élevées.</p></div>

```powershell
Import-Module LAPS -ErrorAction SilentlyContinue
$isImport = Get-Module -List LAPS
if ($isImport)
{
    try
        {
         $null2 = [System.DirectoryServices.ActiveDirectory.Domain]::GetComputerDomain()
         $isDomain = $true
        }
    catch
        {
         $isDomain = $false
        }

    if ($isDomain)
    {
        $MyPassword=Get-LapsADPassword -Identity $PARAMETER1$ -AsPlainText
        if ($MyPassword.Password)
           {
            $Result.Username="%USERNAME%"
            $Result.Password=$MyPassword.Password
           }
        else
           {
            $Result.Cancel=$True
            $Result.ErrorMessage="LAPS did not return any value!"
           }
    }
    else
    {
        $Result.Cancel=$True
        $Result.ErrorMessage="Your computer must be connected to a domain to use LAPS features!"
    }
}
else
{
        $Result.Cancel=$True
        $Result.ErrorMessage="The LAPS module must be installed in this architecture!"
}
```

![](https://cdnweb.devolutions.net/docs/docs_en_kb_KB2336.png)

6. Dans l'onglet ***Paramètres***, ajoutez le nom du compte administrateur local dans le champ ***Paramètre #1***.

   ![](https://cdnweb.devolutions.net/docs/docs_en_kb_KB2337.png)
7. Cliquez sur ***Ajouter*** pour enregistrer l'entrée dans le dossier de destination spécifié.
8. Dans les propriétés de votre entrée RDP, définissez la propriété d'identifiants pour utiliser l'entrée d'identifiants ***Personnalisé*** nouvellement créée.

   ![](https://cdnweb.devolutions.net/docs/docs_en_kb_KB2338.png)
9. Toujours dans les propriétés de l'entrée RDP, allez à ***Avancé*** – ***Avancé***.
10. Définissez la propriété ***Remplacer le domaine*** à ***Utiliser le nom d'hôte*** et la ***propriété Format du nom d'utilisateur*** à ***{Domain}\\{User}***.

    ![](https://cdnweb.devolutions.net/docs/docs_en_kb_KB2339.png)
11. Cliquez sur ***Mettre à jour*** pour enregistrer vos modifications.

L'entrée RDP est maintenant prête à être utilisée et à se connecter avec le compte administrateur local géré par Windows LAPS.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.devolutions.net/rdm/fr/knowledge-base/how-to-articles/configure-laps-with-a-custom-credentials-entry.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.