Comment supprimer un ordinateur d’un domaine avec PowerShell

Dans le monde de la gestion informatique, il est fondamental de s’assurer que les appareils sont correctement ajoutés ou retirés d’un domaine de réseau. Pour les professionnels de l’informatique, cette tâche est généralement répétitive, mais on ne saurait trop insister sur l’importance d’une exécution sans faille. Aujourd’hui, nous allons nous plonger dans un script PowerShell conçu pour supprimer un ordinateur d’un domaine, sans aucun effort.

Contexte

Le script fourni répond au besoin spécifique d’automatiser les opérations de sortie du domaine. Les domaines servent à regrouper les comptes d’utilisateurs, les ordinateurs et les stratégies de groupe de façon centralisée. Un professionnel de l’informatique peut vouloir retirer un ordinateur d’un domaine pour diverses raisons, qu’il s’agisse de sécurité, de changements d’infrastructure ou de mise hors service du matériel. L’exécution manuelle de cette tâche n’est pas seulement chronophage, elle est également sujette à des erreurs humaines. C’est pourquoi un script PowerShell performant comme celui présenté ci-dessus est inestimable pour les professionnels de l’informatique et les fournisseurs de services gérés (MSP).

Le script

#Requires -Version 2.0

<#
.SYNOPSIS
    Removes the computer from the domain.
.DESCRIPTION
    Removes the computer from the domain.
.EXAMPLE
     -UserName "MyDomainUser" -Password "Somepass1" -LocalUserName "Administrator" -LocalPassword "Somepass1"
    Removes the computer from the domain and restarts the computer.
.EXAMPLE
     -UserName "MyDomainUser" -Password "Somepass1" -LocalUserName "Administrator" -LocalPassword "Somepass1" -NoRestart
    Removes the computer from the domain and does not restart the computer.
.EXAMPLE
    PS C:> Leave-Domain.ps1 -UserName "MyDomainUser" -Password "Somepass1" -LocalUserName "Administrator" -LocalPassword "Somepass1" -NoRestart
    Removes the computer from the domain and does not restart the computer.
.OUTPUTS
    String[]
.NOTES
    Minimum OS Architecture Supported: Windows 7, Windows Server 2012
    Release Notes:
    Initial Release
By using this script, you indicate your acceptance of the following legal terms as well as our Terms of Use at https://www.ninjaone.com/terms-of-use.
    Ownership Rights: NinjaOne owns and will continue to own all right, title, and interest in and to the script (including the copyright). NinjaOne is giving you a limited license to use the script in accordance with these legal terms. 
    Use Limitation: You may only use the script for your legitimate personal or internal business purposes, and you may not share the script with another party. 
    Republication Prohibition: Under no circumstances are you permitted to re-publish the script in any script library or website belonging to or under the control of any other software provider. 
    Warranty Disclaimer: The script is provided “as is” and “as available”, without warranty of any kind. NinjaOne makes no promise or guarantee that the script will be free from defects or that it will meet your specific needs or expectations. 
    Assumption of Risk: Your use of the script is at your own risk. You acknowledge that there are certain inherent risks in using the script, and you understand and assume each of those risks. 
    Waiver and Release: You will not hold NinjaOne responsible for any adverse or unintended consequences resulting from your use of the script, and you waive any legal or equitable rights or remedies you may have against NinjaOne relating to your use of the script. 
    EULA: If you are a NinjaOne customer, your use of the script is subject to the End User License Agreement applicable to you (EULA).
.COMPONENT
    ManageUsers
#>

[CmdletBinding()]
param (
    # Use a Domain UserName to remove this computer to a domain, this requires the Password parameter to be used as well
    [Parameter(Mandatory = $true)]
    [String]
    $UserName,
    # Use a Domain Password to remove a computer from a domain
    [Parameter(Mandatory = $true)]
    $Password,
    # Use a local admin's UserName to remove this computer from a domain, this requires the Password parameter to be used as well
    [Parameter(Mandatory = $true)]
    [String]
    $LocalUserName,
    # Use a local admin's Password to remove this computer from a domain
    [Parameter(Mandatory = $true)]
    $LocalPassword,
    # Do not restart computer after leaving to a domain
    [Switch]
    $NoRestart
)
    
begin {
    Write-Output "Starting Leave Domain"
    
    # Converts username and password into a credential object
    $LeaveCred = [PSCredential]::new($UserName, $(ConvertTo-SecureString -String $Password -AsPlainText -Force))
    
    # Converts username and password into a credential object
    $LocalCred = [PSCredential]::new($LocalUserName, $(ConvertTo-SecureString -String $LocalPassword -AsPlainText -Force))
}
    
process {
    Write-Output "Removing computer($env:COMPUTERNAME) from domain"
    $script:LeaveResult = $false
    try {
        $LeaveResult = if ($NoRestart) {
            (Remove-Computer -UnjoinDomainCredential $LeaveCred -PassThru -Force -LocalCredential $LocalCred -Confirm:$false).HasSucceeded
            # Do not restart after leaving
        }
        else {
            # Restart after leaving
            (Remove-Computer -UnjoinDomainCredential $LeaveCred -PassThru -Force -Restart -LocalCredential $LocalCred -Confirm:$false).HasSucceeded
        }    
    }
    catch {
        Write-Error "Failed to Leave Domain"
    }
    if ($LeaveResult) {
        if ($NoRestart) {
            Write-Output "Removed computer($env:COMPUTERNAME) from domain and not restarting computer"
        }
        else {
            Write-Output "Removed computer($env:COMPUTERNAME) from domain and restarting computer"
        }
    }
    else {
        Write-Output "Failed to remove computer($env:COMPUTERNAME) from domain"
        # Clean up credentials so that they don't leak outside this script
        $LeaveCred = $null
        $LocalCred = $null
        exit 1
    }
}
    
end {
    # Clean up credentials so that they don't leak outside this script
    $LeaveCred = $null
    $LocalCred = $null
    Write-Output "Completed Leave Domain"
}

 

Description détaillée

Le texte suit une approche modulaire, comprenant trois sections principales : begin, process et end.

• Dans la section « begin », il initialise le script, accepte des paramètres tels que le domaine et les noms d’utilisateur/mots de passe locaux, et construit des objets d’authentification à partir de ces paramètres.
• La section « process »  » est celle où se déroule l’opération proprement dite. Il utilise la cmdlet Remove-Computer de PowerShell, un outil puissant conçu pour supprimer l’ordinateur de son domaine actuel. La flexibilité du script permet de redémarrer l’ordinateur après la suppression ou de le laisser en marche, selon les préférences de l’utilisateur.
• La section « end » concerne le nettoyage, en veillant à ce que les informations d’identification utilisées soient effacées afin d’éviter tout problème de sécurité potentiel.

Cas d’utilisation potentiels

Imaginez un professionnel de l’informatique, Alex, qui gère l’infrastructure du réseau d’une entreprise de taille moyenne. Ils viennent de mettre hors service plusieurs anciens postes de travail et les ont remplacés par de nouveaux. Au lieu de séparer manuellement chaque ordinateur du domaine, Alex utilise ce script, ce qui lui permet d’économiser des heures de travail et de s’assurer qu’aucune information d’identification résiduelle n’est laissée sur les machines mises hors service.

Comparaisons

Alors que la méthode basée sur l’interface graphique, via les « Propriétés du système », offre une approche plus visuelle, le script PowerShell excelle en termes d’automatisation, d’évolutivité et de précision. Pour supprimer un seul ordinateur, l’interface graphique peut suffire, mais pour les opérations à grande échelle, PowerShell n’a pas d’égal.

FAQ

• Ai-je besoin de droits d’administrateur pour exécuter ce script ? Oui, la suppression d’un ordinateur d’un domaine nécessite des droits d’administrateur à la fois sur la machine locale et sur le domaine.
• Que se passe-t-il si je ne fournis pas le commutateur -NoRestart ? Par défaut, l’ordinateur redémarre après avoir été retiré du domaine.

Implications

L’utilisation de scripts de ce type pour gérer les opérations du domaine n’est pas seulement une question de commodité, mais aussi de sécurité. Il est primordial de s’assurer que les informations d’identification ne fuient pas, comme le fait ce script. Une suppression de domaine mal gérée peut laisser des failles aux cyber-attaquants.

Recommandations

• Testez toujours le script dans un environnement contrôlé avant de le déployer dans un scénario réel.
• Veillez à ce que des mécanismes de sauvegarde soient en place, en particulier lorsque vous effectuez des modifications importantes.
• Mettez régulièrement le script à jour pour tenir compte des modifications apportées au système d’exploitation ou aux commandes PowerShell.

Conclusion

Si les scripts PowerShell tels que celui présenté ici sont d’une grande utilité, l’utilisation de plateformes telles que NinjaOne permet de rationaliser davantage les opérations informatiques. NinjaOne fournit une plateforme unifiée de surveillance et de gestion informatique, intégrant de manière optimale les scripts, l’automatisation et une multitude de tâches informatiques au même endroit. Pour les professionnels qui cherchent à optimiser leurs tâches de gestion informatique, des outils comme ce script, lorsqu’ils sont intégrés à des plateformes comme NinjaOne, offrent un horizon prometteur.