{"id":260409,"date":"2024-05-24T14:51:31","date_gmt":"2024-05-24T14:51:31","guid":{"rendered":"https:\/\/www.ninjaone.com\/?post_type=script_hub&p=260409"},"modified":"2024-05-24T14:51:31","modified_gmt":"2024-05-24T14:51:31","slug":"anadir-un-equipo-a-un-dominio","status":"publish","type":"script_hub","link":"https:\/\/www.ninjaone.com\/es\/script-hub\/anadir-un-equipo-a-un-dominio\/","title":{"rendered":"C\u00f3mo a\u00f1adir un equipo a un dominio mediante PowerShell"},"content":{"rendered":"

En el panorama inform\u00e1tico moderno, garantizar que un ordenador se una al dominio adecuado es m\u00e1s que una comodidad: es un paso esencial para consolidar el control, simplificar el acceso y mantener la seguridad de la red. Este script PowerShell est\u00e1 dise\u00f1ado para agilizar el proceso de a\u00f1adir un equipo a un dominio.<\/strong><\/p>\n

Antecedentes<\/h2>\n

PowerShell ha cobrado importancia entre los profesionales de TI y los proveedores de servicios gestionados (MSP)<\/a> como lenguaje de scripting robusto y vers\u00e1til. Su flexibilidad permite a los administradores automatizar tareas repetitivas, aplicar pol\u00edticas y configurar sistemas con rapidez. El script que aqu\u00ed se presenta cumple una funci\u00f3n crucial: permite que los ordenadores se unan a un dominio sin problemas. Los dominios son fundamentales en el mundo inform\u00e1tico empresarial, ya que facilitan el uso compartido de recursos, la autenticaci\u00f3n centralizada y la aplicaci\u00f3n de pol\u00edticas. Por tanto, un script que pueda a\u00f1adir ordenadores a un dominio de forma fiable a\u00f1ade un valor inmenso.<\/p>\n

El script para a\u00f1adir un equipo a un dominio<\/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
Accede a m\u00e1s de 300 scripts en el Dojo de NinjaOne<\/p>\n
Obt\u00e9n acceso<\/a><\/p>\n<\/div>\n
An\u00e1lisis detallado<\/h2>\n
El script comienza con metadatos exhaustivos que describen su finalidad, ejemplos de uso y resultados esperados. La l\u00f3gica central sigue un esquema de funciones est\u00e1ndar de PowerShell: inicio, proceso y fin.<\/p>\n