{"id":208399,"date":"2024-01-17T09:20:40","date_gmt":"2024-01-17T09:20:40","guid":{"rendered":"https:\/\/www.ninjaone.com\/script-hub\/comment-ajouter-un-ordinateur-a-un-domaine-avec-powershell\/"},"modified":"2024-03-04T19:12:08","modified_gmt":"2024-03-04T19:12:08","slug":"comment-ajouter-un-ordinateur-a-un-domaine-avec-powershell","status":"publish","type":"script_hub","link":"https:\/\/www.ninjaone.com\/fr\/script-hub\/comment-ajouter-un-ordinateur-a-un-domaine-avec-powershell\/","title":{"rendered":"Comment ajouter un ordinateur \u00e0 un domaine avec PowerShell"},"content":{"rendered":"

Dans le monde informatique moderne, s’assurer qu’un ordinateur rejoint le domaine appropri\u00e9 est plus qu’une commodit\u00e9, c’est une \u00e9tape essentielle pour renforcer le contr\u00f4le, simplifier l’acc\u00e8s et maintenir la s\u00e9curit\u00e9 du r\u00e9seau. Ce script PowerShell est con\u00e7u pour simplifier le processus pour ajouter un ordinateur \u00e0 un domaine<\/strong>.<\/p>\n

Contexte<\/h2>\n

PowerShell s’est impos\u00e9 aupr\u00e8s des professionnels de l’informatique et des fournisseurs de services g\u00e9r\u00e9s (MSP)<\/a> comme un langage de script performant et polyvalent. Sa flexibilit\u00e9 permet aux administrateurs d’automatiser les t\u00e2ches r\u00e9p\u00e9titives, d’appliquer des strat\u00e9gies et de configurer rapidement les syst\u00e8mes. Le script pr\u00e9sent\u00e9 ici remplit une fonction cruciale : il permet aux ordinateurs de rejoindre un domaine de fa\u00e7on simple. Les domaines sont essentiels dans le monde de l’informatique d’entreprise, car ils facilitent le partage des ressources, l’authentification centralis\u00e9e et l’application des strat\u00e9gies. Un script capable d’ajouter de mani\u00e8re fiable des ordinateurs \u00e0 un domaine apporte donc une valeur ajout\u00e9e consid\u00e9rable.<\/p>\n

Le script<\/h2>\n
#Requires -Version 5.1\r\n\r\n<#\r\n.SYNOPSIS\r\n    Joins a computer to a domain.\r\n.DESCRIPTION\r\n    Joins a computer to a domain.\r\n.EXAMPLE\r\n     -DomainName \"Domain.com\" -UserName \"DomainMyDomainUser\" -Password \"Somepass1\"\r\n    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.\r\n.EXAMPLE\r\n     -DomainName \"Domain.com\" -UserName \"DomainMyDomainUser\" -Password \"Somepass1\" -NoRestart\r\n    Joins a computer to a \"Domain.com\" domain and does not restart the computer.\r\n.EXAMPLE\r\n    PS C:> Join-Domain.ps1 -DomainName \"domain.com\" -UserName \"DomainMyDomainUser\" -Password \"Somepass1\" -NoRestart\r\n    Joins a computer to a \"Domain.com\" domain and does not restart the computer.\r\n.EXAMPLE\r\n     -DomainName \"Domain.com\" -UserName \"DomainMyDomainUser\" -Password \"Somepass1\" -Server \"192.168.0.1\"\r\n    Not recommended if the computer this script is running on does not have one of the Domain Controllers set as its DNS server.\r\n    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.\r\n.OUTPUTS\r\n    String[]\r\n.NOTES\r\n    Minimum OS Architecture Supported: Windows 10, Windows Server 2016\r\n    Release Notes:\r\n    Initial Release\r\nBy 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.\r\n    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. \r\n    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. \r\n    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. \r\n    Warranty Disclaimer: The script is provided \u201cas is\u201d and \u201cas available\u201d, 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. \r\n    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. \r\n    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. \r\n    EULA: If you are a NinjaOne customer, your use of the script is subject to the End User License Agreement applicable to you (EULA).\r\n.COMPONENT\r\n    ManageUsers\r\n#>\r\n\r\n[CmdletBinding()]\r\nparam (\r\n    # Domain Name to join computer to\r\n    [Parameter(Mandatory = $true)]\r\n    [String]\r\n    $DomainName,\r\n    # Use a Domain UserName to join this computer to a domain, this requires the Password parameter to be used as well\r\n    [Parameter(Mandatory = $true)]\r\n    [String]\r\n    $UserName,\r\n    # Use a Domain Password to join this computer from a domain\r\n    [Parameter(Mandatory = $true)]\r\n    $Password,\r\n    # Used only when computer can't locate a domain controler via DNS or you wish to connect to a specific DC\r\n    [Parameter()]\r\n    $Server,\r\n    # Do not restart computer after joining to a domain\r\n    [Switch]\r\n    $NoRestart\r\n)\r\n    \r\nbegin {\r\n    function Join-ComputerToDomainPS2 {\r\n        param (\r\n            [String]\r\n            $DomainName,\r\n            [PSCredential]\r\n            $Credential,\r\n            $Restart,\r\n            $Server\r\n        )\r\n        if ($Credential) {\r\n            # Use supplied Credentials\r\n            if ($Server) {\r\n                Add-Computer -DomainName $DomainName -Credential $Credential -Server $Server -Force -Confirm:$false -PassThru\r\n            }\r\n            else {\r\n                Add-Computer -DomainName $DomainName -Credential $Credential -Force -Confirm:$false -PassThru\r\n            }\r\n        }\r\n        else {\r\n            # No Credentials supplied, use current user\r\n            Add-Computer -DomainName $DomainName -Force -Confirm:$false -PassThru\r\n        }\r\n    }\r\n    Write-Output \"Starting Join Domain\"\r\n    \r\n    # Convert username and password into a credential object\r\n    $JoinCred = [PSCredential]::new($UserName, $(ConvertTo-SecureString -String $Password -AsPlainText -Force))\r\n}\r\n    \r\nprocess {\r\n    Write-Output \"Joining computer($env:COMPUTERNAME) to domain $DomainName\"\r\n    $script:JoinResult = $false\r\n    try {\r\n        $JoinResult = if ($NoRestart) {\r\n            # Do not restart after joining\r\n            if ($PSVersionTable.PSVersion.Major -eq 2) {\r\n                if ($Server) {\r\n                    (Join-ComputerToDomainPS2 -DomainName $DomainName -Credential $Credential -Server $Server).HasSucceeded\r\n                }\r\n                else {\r\n                    (Join-ComputerToDomainPS2 -DomainName $DomainName -Credential $Credential).HasSucceeded\r\n                }\r\n            }\r\n            else {\r\n                if ($Server) {\r\n                    (Add-Computer -DomainName $DomainName -Credential $JoinCred -Server $Server -Force -Confirm:$false -PassThru).HasSucceeded\r\n                }\r\n                else {\r\n                    (Add-Computer -DomainName $DomainName -Credential $JoinCred -Force -Confirm:$false -PassThru).HasSucceeded\r\n                }\r\n            }\r\n        }\r\n        else {\r\n            # Restart after joining\r\n            if ($PSVersionTable.PSVersion.Major -eq 2) {\r\n                if ($Server) {\r\n                    (Join-ComputerToDomainPS2 -DomainName $DomainName -Credential $Credential -Server $Server).HasSucceeded\r\n                }\r\n                else {\r\n                    (Join-ComputerToDomainPS2 -DomainName $DomainName -Credential $Credential).HasSucceeded\r\n                }\r\n            }\r\n            else {\r\n                if ($Server) {\r\n                    (Add-Computer -DomainName $DomainName -Credential $JoinCred -Restart -Server $Server -Force -Confirm:$false -PassThru).HasSucceeded\r\n                }\r\n                else {\r\n                    (Add-Computer -DomainName $DomainName -Credential $JoinCred -Restart -Force -Confirm:$false -PassThru).HasSucceeded\r\n                }\r\n            }\r\n        }    \r\n    }\r\n    catch {\r\n        Write-Error \"Failed to Join Domain: $DomainName\"\r\n    }\r\n\r\n    if ($NoRestart -and $JoinResult) {\r\n        Write-Output \"Joined computer($env:COMPUTERNAME) to Domain: $DomainName and not restarting computer\"\r\n    }\r\n    elseif ($JoinResult) {\r\n        Write-Output \"Joined computer($env:COMPUTERNAME) to Domain: $DomainName and restarting computer\"\r\n        if ($PSVersionTable.PSVersion.Major -eq 2) {\r\n            shutdown.exe -r -t 60\r\n        }\r\n    }\r\n    else {\r\n        Write-Output \"Failed to Join computer($env:COMPUTERNAME) to Domain: $DomainName\"\r\n        # Clean up credentials so that they don't leak outside this script\r\n        $JoinCred = $null\r\n        exit 1\r\n    }\r\n}\r\n    \r\nend {\r\n    # Clean up credentials so that they don't leak outside this script\r\n    $JoinCred = $null\r\n    Write-Output \"Completed Join Domain\"\r\n}<\/pre>\n
 <\/p>\n\n
Acc\u00e9dez \u00e0 plus de 700 scripts dans le Dojo NinjaOne<\/p>\n
Obtenez l’acc\u00e8s<\/a><\/p>\n<\/div>\n
Description d\u00e9taill\u00e9e<\/h2>\n
Le script commence par des m\u00e9tadonn\u00e9es compl\u00e8tes, d\u00e9crivant son objectif, des exemples d’utilisation et les r\u00e9sultats attendus. La logique de base suit la disposition standard des fonctions PowerShell : d\u00e9but, processus et fin.<\/p>\n