Comment ajouter un ordinateur à un domaine avec PowerShell

Dans le monde informatique moderne, s’assurer qu’un ordinateur rejoint le domaine approprié est plus qu’une commodité, c’est une étape essentielle pour renforcer le contrôle, simplifier l’accès et maintenir la sécurité du réseau. Ce script PowerShell est conçu pour simplifier le processus pour ajouter un ordinateur à un domaine.

Contexte

PowerShell s’est imposé auprès des professionnels de l’informatique et des fournisseurs de services gérés (MSP) comme un langage de script performant et polyvalent. Sa flexibilité permet aux administrateurs d’automatiser les tâches répétitives, d’appliquer des stratégies et de configurer rapidement les systèmes. Le script présenté ici remplit une fonction cruciale : il permet aux ordinateurs de rejoindre un domaine de façon simple. Les domaines sont essentiels dans le monde de l’informatique d’entreprise, car ils facilitent le partage des ressources, l’authentification centralisée et l’application des stratégies. Un script capable d’ajouter de manière fiable des ordinateurs à un domaine apporte donc une valeur ajoutée considérable.

Le script

#Requires -Version 5.1

<#
.SYNOPSIS
    Joins a computer to a domain.
.DESCRIPTION
    Joins a computer to a domain.
.EXAMPLE
     -DomainName "Domain.com" -UserName "DomainMyDomainUser" -Password "Somepass1"
    Joins a computer to a "Domain.com" domain and restarts the computer. Don't expect a success result in Ninja as the computer will reboot before the script can return a result.
.EXAMPLE
     -DomainName "Domain.com" -UserName "DomainMyDomainUser" -Password "Somepass1" -NoRestart
    Joins a computer to a "Domain.com" domain and does not restart the computer.
.EXAMPLE
    PS C:> Join-Domain.ps1 -DomainName "domain.com" -UserName "DomainMyDomainUser" -Password "Somepass1" -NoRestart
    Joins a computer to a "Domain.com" domain and does not restart the computer.
.EXAMPLE
     -DomainName "Domain.com" -UserName "DomainMyDomainUser" -Password "Somepass1" -Server "192.168.0.1"
    Not recommended if the computer this script is running on does not have one of the Domain Controllers set as its DNS server.
    Joins a computer to a "Domain.com" domain, talks to the domain with the IP address of "192.168.0.1", and restarts the computer.
.OUTPUTS
    String[]
.NOTES
    Minimum OS Architecture Supported: Windows 10, Windows Server 2016
    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 (
    # Domain Name to join computer to
    [Parameter(Mandatory = $true)]
    [String]
    $DomainName,
    # Use a Domain UserName to join 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 join this computer from a domain
    [Parameter(Mandatory = $true)]
    $Password,
    # Used only when computer can't locate a domain controler via DNS or you wish to connect to a specific DC
    [Parameter()]
    $Server,
    # Do not restart computer after joining to a domain
    [Switch]
    $NoRestart
)
    
begin {
    function Join-ComputerToDomainPS2 {
        param (
            [String]
            $DomainName,
            [PSCredential]
            $Credential,
            $Restart,
            $Server
        )
        if ($Credential) {
            # Use supplied Credentials
            if ($Server) {
                Add-Computer -DomainName $DomainName -Credential $Credential -Server $Server -Force -Confirm:$false -PassThru
            }
            else {
                Add-Computer -DomainName $DomainName -Credential $Credential -Force -Confirm:$false -PassThru
            }
        }
        else {
            # No Credentials supplied, use current user
            Add-Computer -DomainName $DomainName -Force -Confirm:$false -PassThru
        }
    }
    Write-Output "Starting Join Domain"
    
    # Convert username and password into a credential object
    $JoinCred = [PSCredential]::new($UserName, $(ConvertTo-SecureString -String $Password -AsPlainText -Force))
}
    
process {
    Write-Output "Joining computer($env:COMPUTERNAME) to domain $DomainName"
    $script:JoinResult = $false
    try {
        $JoinResult = if ($NoRestart) {
            # Do not restart after joining
            if ($PSVersionTable.PSVersion.Major -eq 2) {
                if ($Server) {
                    (Join-ComputerToDomainPS2 -DomainName $DomainName -Credential $Credential -Server $Server).HasSucceeded
                }
                else {
                    (Join-ComputerToDomainPS2 -DomainName $DomainName -Credential $Credential).HasSucceeded
                }
            }
            else {
                if ($Server) {
                    (Add-Computer -DomainName $DomainName -Credential $JoinCred -Server $Server -Force -Confirm:$false -PassThru).HasSucceeded
                }
                else {
                    (Add-Computer -DomainName $DomainName -Credential $JoinCred -Force -Confirm:$false -PassThru).HasSucceeded
                }
            }
        }
        else {
            # Restart after joining
            if ($PSVersionTable.PSVersion.Major -eq 2) {
                if ($Server) {
                    (Join-ComputerToDomainPS2 -DomainName $DomainName -Credential $Credential -Server $Server).HasSucceeded
                }
                else {
                    (Join-ComputerToDomainPS2 -DomainName $DomainName -Credential $Credential).HasSucceeded
                }
            }
            else {
                if ($Server) {
                    (Add-Computer -DomainName $DomainName -Credential $JoinCred -Restart -Server $Server -Force -Confirm:$false -PassThru).HasSucceeded
                }
                else {
                    (Add-Computer -DomainName $DomainName -Credential $JoinCred -Restart -Force -Confirm:$false -PassThru).HasSucceeded
                }
            }
        }    
    }
    catch {
        Write-Error "Failed to Join Domain: $DomainName"
    }

    if ($NoRestart -and $JoinResult) {
        Write-Output "Joined computer($env:COMPUTERNAME) to Domain: $DomainName and not restarting computer"
    }
    elseif ($JoinResult) {
        Write-Output "Joined computer($env:COMPUTERNAME) to Domain: $DomainName and restarting computer"
        if ($PSVersionTable.PSVersion.Major -eq 2) {
            shutdown.exe -r -t 60
        }
    }
    else {
        Write-Output "Failed to Join computer($env:COMPUTERNAME) to Domain: $DomainName"
        # Clean up credentials so that they don't leak outside this script
        $JoinCred = $null
        exit 1
    }
}
    
end {
    # Clean up credentials so that they don't leak outside this script
    $JoinCred = $null
    Write-Output "Completed Join Domain"
}

 

Accédez à plus de 700 scripts dans le Dojo NinjaOne

Obtenez l’accès

Description détaillée

Le script commence par des métadonnées complètes, décrivant son objectif, des exemples d’utilisation et les résultats attendus. La logique de base suit la disposition standard des fonctions PowerShell : début, processus et fin.

  • Paramètres: Il s’agit des données fournies par l’utilisateur, notamment le nom de domaine, le nom d’utilisateur, le mot de passe et le serveur. Un paramètre de commutation appelé NoRestart permet aux utilisateurs de décider s’ils veulent que l’ordinateur redémarre après avoir rejoint le domaine.
  • Bloc « begin »: Cette section permet d’initialiser le script. Il définit une fonction Join-ComputerToDomainPS2 et convertit le nom d’utilisateur et le mot de passe fournis en un objet d’authentification sécurisé, prêt à être utilisé dans le processus d’enrôlement.
  • Bloc « process »: La logique centrale réside ici. En fonction des paramètres fournis, le script joindra l’ordinateur au domaine avec ou sans redémarrage. Il utilise deux commandes PowerShell principales : Add-Computer et une fonction définie par l’utilisateur. Si des erreurs surviennent au cours de ce processus, elles sont détectées et signalées.
  • Bloc « end »: Cette opération finalise le script, en nettoyant les informations d’identification utilisées au cours de son exécution.

Cas d’utilisation potentiels

Étude de cas: Imaginez une entreprise MSP qui s’occupe de l’informatique de plusieurs petites entreprises. Elle vient de déployer 50 nouvelles machines et a besoin qu’elles soient toutes connectées au domaine de l’entreprise avant le début des activités le lendemain. À l’aide du script, l’entreprise MSP introduit rapidement les informations requises pour toutes les machines. En quelques minutes, chaque ordinateur est configuré, sans qu’il soit nécessaire de procéder à des configurations manuelles ou à des mises en place fastidieuses.

Comparaisons

Les méthodes traditionnelles de connexion d’un ordinateur à un domaine impliquent des étapes manuelles via l’interface Windows ou l’utilisation de scripts hérités. Ces méthodes peuvent prendre du temps, être sujettes à des erreurs et ne sont pas adaptées aux déploiements de grande envergure. Notre approche PowerShell est plus efficace, moins sujette aux erreurs et s’adapte à plusieurs machines.

FAQ

  • Ce script peut-il gérer les ajouts massifs d’ordinateurs à un domaine ?
    Oui, avec une logique de bouclage appropriée, vous pouvez traiter plusieurs ordinateurs.
  • Que se passe-t-il si les coordonnées du domaine sont incorrectes ?
    Le script génère une erreur indiquant l’échec de la jonction de domaines.

Implications

Le fait de rejoindre des domaines de manière incorrecte ou d’exposer des informations d’identification peut nuire à la sécurité informatique. Si un ordinateur rejoint le mauvais domaine, il risque d’accéder à des ressources non autorisées ou d’être exposé à des risques de sécurité.

Recommandations

  • Toujours valider les détails du domaine avant l’exécution.
  • Protéger les informations d’identification du domaine et les modifier régulièrement.
  • Testez le script dans un environnement contrôlé avant de le déployer.

Conclusion

À une époque où l’automatisation règne en maître, des outils comme ce script, combinés à des plateformes comme NinjaOne, peuvent améliorer l’efficacité, la sécurité et la facilité de gestion. NinjaOne, en particulier, offre de solides fonctions de surveillance et de gestion, garantissant qu’une fois les ordinateurs ajoutés au domaine, ils restent conformes, sécurisés et optimisés en termes de performances.

Pour aller plus loin

Créer une équipe informatique efficace et performante nécessite une solution centralisée qui soit l’outil principal pour fournir vos services. NinjaOne permet aux équipes informatiques de surveiller, gérer, sécuriser et prendre en charge tous les appareils, où qu’ils soient, sans avoir besoin d’une infrastructure complexe sur site.

Pour en savoir plus sur NinjaOne Endpoint Management, participez à une visite guidée ou commencez votre essai gratuit de la plateforme NinjaOne.

Catégories :

Vous pourriez aussi aimer

Voir la démo×
×

Voir NinjaOne en action !

En soumettant ce formulaire, j'accepte la politique de confidentialité de NinjaOne.

Termes et conditions NinjaOne

En cliquant sur le bouton « J’accepte » ci-dessous, vous indiquez que vous acceptez les termes juridiques suivants ainsi que nos conditions d’utilisation:

  • Droits de propriété: NinjaOne possède et continuera de posséder tous les droits, titres et intérêts relatifs au script (y compris les droits d’auteur). NinjaOne vous accorde une licence limitée pour l’utilisation du script conformément à ces conditions légales.
  • Limitation de l’utilisation: Les scripts ne peuvent être utilisés qu’à des fins personnelles ou professionnelles internes légitimes et ne peuvent être partagés avec d’autres entités.
  • Interdiction de publication: Vous n’êtes en aucun cas autorisé à publier le script dans une bibliothèque de scripts appartenant à, ou sous le contrôle d’un autre fournisseur de logiciels.
  • Clause de non-responsabilité: Le texte est fourni « tel quel » et « tel que disponible », sans garantie d’aucune sorte. NinjaOne ne promet ni ne garantit que le script sera exempt de défauts ou qu’il répondra à vos besoins ou attentes particulières.
  • Acceptation des risques: L’utilisation du script est sous votre propre responsabilité. Vous reconnaissez qu’il existe certains risques inhérents à l’utilisation du script, et vous comprenez et assumez chacun de ces risques.
  • Renonciation et exonération de responsabilité: Vous ne tiendrez pas NinjaOne pour responsable des conséquences négatives ou involontaires résultant de votre utilisation du script, et vous renoncez à tout droit ou recours légal ou équitable que vous pourriez avoir contre NinjaOne en rapport avec votre utilisation du script.
  • EULA: Si vous êtes un client de NinjaOne, votre utilisation du script est soumise au contrat de licence d’utilisateur final qui vous est applicable (End User License Agreement (EULA)).