Compartir a través de

Add-Computer

  • Referencia
Módulo:
Microsoft.PowerShell.Management

Agrega el equipo local a un dominio o grupo de trabajo.

Sintaxis

Add-Computer
   [-ComputerName <String[]>]
   [-LocalCredential <PSCredential>]
   [-UnjoinDomainCredential <PSCredential>]
   -Credential <PSCredential>
   [-DomainName] <String>
   [-OUPath <String>]
   [-Server <String>]
   [-Unsecure]
   [-Options <JoinOptions>]
   [-Restart]
   [-PassThru]
   [-NewName <String>]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-Computer
   [-ComputerName <String[]>]
   [-LocalCredential <PSCredential>]
   [-Credential <PSCredential>]
   [-WorkgroupName] <String>
   [-Restart]
   [-PassThru]
   [-NewName <String>]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El Add-Computer cmdlet agrega el equipo local o los equipos remotos a un dominio o grupo de trabajo, o los mueve de un dominio a otro. También crea una cuenta de dominio si el equipo se agrega al dominio sin una cuenta.

Puede utilizar los parámetros de este cmdlet para especificar una unidad organizativa (OU) y el controlador de dominio, o para realizar una unión no segura.

Para obtener los resultados del comando, use los parámetros Verbose y PassThru .

Ejemplos

Ejemplo 1: Agregar un equipo local a un dominio y, a continuación, reiniciar el equipo

Add-Computer -DomainName Domain01 -Restart

Este comando agrega el equipo local en el dominio Domain01 y, después, reinicia el equipo para que el cambio surta efecto.

Ejemplo 2: Agregar un equipo local a un grupo de trabajo

Add-Computer -WorkgroupName WORKGROUP-A

Este comando agrega el equipo local al grupo de trabajo Workgroup-A.

Ejemplo 3: Agregar un equipo local a un dominio

Add-Computer -DomainName Domain01 -Server Domain01\DC01 -PassThru -Verbose

Este comando agrega el equipo local al dominio Domain01 mediante el Domain01\DC01 controlador de dominio.

El comando usa los parámetros PassThru y Verbose para obtener información detallada sobre los resultados del comando.

Ejemplo 4: Adición de un equipo local a un dominio mediante el parámetro OUPath

Add-Computer -DomainName Domain02 -OUPath "OU=testOU,DC=domain,DC=Domain,DC=com"

Este comando agrega el equipo local al dominio Domain02. Utiliza el parámetro OUPath para especificar la unidad organizativa de las nuevas cuentas.

Ejemplo 5: Agregar un equipo local a un dominio mediante credenciales

$addComputerSplat = @{
    ComputerName = 'Server01'
    LocalCredential = 'Server01\Admin01'
    DomainName = 'Domain02'
    Credential = 'Domain02\Admin02'
    Restart = $true
    Force = $true
}
Add-Computer @addComputerSplat

Este comando agrega el equipo Server01 al dominio Domain02. Usa el parámetro LocalCredential para especificar una cuenta de usuario que tenga permiso para conectarse al equipo Server01. Usa el parámetro Credential para especificar una cuenta de usuario que tenga permiso para unir equipos al dominio. Usa el parámetro Restart para reiniciar el equipo una vez completada la operación de combinación y el parámetro Force para suprimir los mensajes de confirmación del usuario.

Ejemplo 6: Traslado de un grupo de equipos a un nuevo dominio

$addComputerSplat = @{
    ComputerName = 'Server01', 'Server02', 'localhost'
    DomainName = 'Domain02'
    LocalCredential = 'Domain01\User01'
    UnjoinDomainCredential = 'Domain01\Admin01'
    Credential = 'Domain02\Admin01'
    Restart = $true
}
Add-Computer @addComputerSplat

Este comando mueve los equipos Server01 y Server02, y el equipo local, de Domain01 a Domain02.

Usa el parámetro LocalCredential para especificar una cuenta de usuario que tenga permiso para conectarse a los tres equipos afectados. Usa el parámetro UnjoinDomainCredential para especificar una cuenta de usuario que tenga permiso para descomprimir los equipos del dominio Domain01 y el parámetro Credential para especificar una cuenta de usuario que tenga permiso para unir los equipos al dominio Domain02. Usa el parámetro Restart para reiniciar los tres equipos una vez completado el traslado.

Ejemplo 7: Mover un equipo a un nuevo dominio y cambiar el nombre del equipo

$addComputerSplat = @{
    ComputerName = 'Server01'
    DomainName = 'Domain02'
    NewName = 'Server044'
    Credential = 'Domain02\Admin01'
    Restart = $true
}
Add-Computer @addComputerSplat

Este comando mueve el equipo Server01 a Domain02 y cambia el nombre del equipo a Server044.

El comando utiliza la credencial del usuario actual para conectarse al equipo Server01 y separarlo de su dominio actual. Usa el parámetro Credential para especificar una cuenta de usuario que tenga permiso para unir el equipo al dominio Domain02.

Ejemplo 8: Agregar equipos enumerados en un archivo a un nuevo dominio

$addComputerSplat = @{
    ComputerName = (Get-Content Servers.txt)
    DomainName = 'Domain02'
    Credential = 'Domain02\Admin02'
    Options = 'Win9xUpgrade'
    Restart = $true
}
Add-Computer @addComputerSplat

Este comando agrega los equipos que aparecen en el Servers.txt archivo al dominio Domain02. Usa el parámetro Options para especificar la opción Win9xUpgrade . El parámetro Restart reinicia todos los equipos recién agregados una vez completada la operación de unión.

Ejemplo 9: Agregar un equipo a un dominio mediante credenciales de equipo predefinidas

Un administrador debe ejecutar este primer comando desde un equipo que ya esté unido al dominio Domain03:

$newADComputerSplat = @{
    Name = "Server02"
    AccountPassword = (ConvertTo-SecureString -String 'TempJoinPA$$' -AsPlainText -Force)
}
New-ADComputer @newADComputerSplat

# Then this command is run from `Server02` which is not yet domain-joined:

$joinCred = New-Object pscredential -ArgumentList ([pscustomobject]@{
    UserName = $null
    Password = (ConvertTo-SecureString -String 'TempJoinPA$$' -AsPlainText -Force)[0]
})
$addComputerSplat = @{
    DomainName = "Domain03"
    Options = 'UnsecuredJoin', 'PasswordPass'
    Credential = $joinCred
}
Add-Computer @addComputerSplat

Esta combinación de comandos crea una nueva cuenta de equipo con un nombre predefinido y una contraseña de unión temporal en un dominio mediante un equipo unido a un dominio existente. A continuación, un equipo con el nombre predefinido combina el dominio con solo el nombre del equipo y la contraseña de combinación temporal. La contraseña predefinida solo se usa para admitir la operación de unión y se reemplaza como parte de los procedimientos normales de la cuenta de equipo después de que el equipo complete la unión.

Ejemplo 10: Agregar un equipo a un dominio con un nuevo nombre

El uso de esta combinación de comandos evita varios reinicios y varias escrituras en Active Directory escribe para el mismo objeto cuando el equipo se une al dominio con el nuevo nombre.

Rename-Computer -NewName "MyNewPC" -Force
$addComputerSplat = @{
    DomainName = 'Contoso.com'
    Credential = 'contoso\administrator'
    Options = 'JoinWithNewName', 'AccountCreate'
}
Add-Computer @addComputerSplat

Parámetros

-ComputerName

Especifica los equipos para agregar a un dominio o grupo de trabajo. La opción predeterminada es el equipo local.

Escriba el nombre NetBIOS, una dirección de Protocolo de Internet (IP) o un nombre de dominio completo de cada uno de los equipos remotos. Para especificar el equipo local, escriba el nombre del equipo, un punto (.) o "localhost".

Este parámetro no utiliza la comunicación remota de Windows PowerShell. Puede usar el parámetro ComputerName de Add-Computer aunque el equipo no esté configurado para ejecutar comandos remotos.

Este parámetro se incorporó en Windows PowerShell 3.0.

Tipo:String[]
Posición:Named
Valor predeterminado:Local computer
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Credential

Especifica una cuenta de usuario que tiene permiso para unir los equipos a un dominio nuevo. El valor predeterminado es el usuario actual.

Escriba un nombre de usuario, como "User01" o "Domain01\User01" o escriba un objeto PSCredential , como uno generado por el Get-Credential cmdlet. Si escribe un nombre de usuario, se le solicitará una contraseña.

Para especificar una cuenta de usuario que tenga permiso para quitar el equipo de su dominio actual, use el parámetro UnjoinDomainCredential . Para especificar una cuenta de usuario que tenga permiso para conectarse a un equipo remoto, use el parámetro LocalCredential .

Tipo:PSCredential
Alias:DomainCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DomainName

Especifica el dominio al que se agregan los equipos. Este parámetro es necesario cuando se agregan los equipos a un dominio.

Tipo:String
Alias:DN, Domain
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Force

Suprime el mensaje de confirmación del usuario. Sin este parámetro, Add-Computer es necesario confirmar la adición de cada equipo.

Este parámetro se incorporó en Windows PowerShell 3.0.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-LocalCredential

Especifica una cuenta de usuario que tiene permiso para conectarse a los equipos especificados por el parámetro ComputerName . El valor predeterminado es el usuario actual.

Escriba un nombre de usuario, como "User01" o "Domain01\User01" o escriba un objeto PSCredential , como uno generado por el Get-Credential cmdlet. Si escribe un nombre de usuario, se le solicitará una contraseña.

Para especificar una cuenta de usuario que tenga permiso para agregar los equipos a un nuevo dominio, use el parámetro Credential . Para especificar una cuenta de usuario que tenga permiso para quitar los equipos de su dominio actual, use el parámetro UnjoinDomainCredential .

Este parámetro se incorporó en Windows PowerShell 3.0.

Tipo:PSCredential
Posición:Named
Valor predeterminado:Current user
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-NewName

Especifica un nombre nuevo para el equipo en el nuevo dominio. Este parámetro es válido solo cuando se está agregando o moviendo un equipo.

Este parámetro se incorporó en Windows PowerShell 3.0.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Options

Especifica opciones avanzadas para la operación de Add-Computer combinación. Escriba uno o más valores en una cadena separada por comas.

Los valores permitidos para este parámetro son los siguientes:

  • AccountCreate: crea una cuenta de dominio. El Add-Computer cmdlet crea automáticamente una cuenta de dominio cuando agrega un equipo a un dominio. Esta opción se incluye por integridad.

  • Win9XUpgrade: indica que la operación de unión forma parte de una actualización del sistema operativo Windows.

  • UnsecuredJoin: realiza una combinación no seguro. Para solicitar una combinación no segura, use el parámetro Unsecure o esta opción. Si desea pasar una contraseña de máquina, debe usar esta opción en combinación con PasswordPass la opción .

  • PasswordPass: establece la contraseña del equipo en el valor del parámetro Credential(DomainCredential) después de realizar una combinación no segura. Esta opción también indica que el valor del parámetro Credential (DomainCredential) es una contraseña de máquina, no una contraseña de usuario. Esta opción solo es válida cuando se especifica la UnsecuredJoin opción. Al usar esta opción, la credencial proporcionada al -Credential parámetro debe tener un nombre de usuario nulo.

  • JoinWithNewName: cambia el nombre del equipo del nuevo dominio al nombre especificado por el parámetro NewName . Cuando se usa el parámetro NewName , esta opción se establece automáticamente. Esta opción está diseñada para usarse con el cmdlet Rename-Computer. Si usa el cmdlet para cambiar el Rename-Computer nombre del equipo, pero no reinicia el equipo para que el cambio sea efectivo, puede usar este parámetro para unir el equipo a un dominio con su nuevo nombre.

  • JoinReadOnly: usa una cuenta de máquina existente para unir el equipo a un controlador de dominio de solo lectura. La cuenta de equipo debe agregarse a la lista de permitidos para la directiva de replicación de contraseñas y la contraseña de la cuenta debe replicarse en el controlador de dominio de solo lectura antes de la operación de unión.

  • InstallInvoke: establece las marcas create (0x2) y delete (0x4) del parámetro FJoinOptions del método JoinDomainOrWorkgroup . Para obtener más información sobre el método JoinDomainOrWorkgroup , vea Método JoinDomainOrWorkgroup de la clase Win32_ComputerSystem. Para obtener más información sobre estas opciones, consulte Función NetJoinDomain.

Este parámetro se incorporó en Windows PowerShell 3.0.

Tipo:JoinOptions
Valores aceptados:AccountCreate, Win9XUpgrade, UnsecuredJoin, PasswordPass, DeferSPNSet, JoinWithNewName, JoinReadOnly, InstallInvoke
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-OUPath

Especifica una unidad organizativa (OU) para la cuenta de dominio. Escriba entre comillas el nombre distintivo de la unidad organizativa. El valor predeterminado es la unidad organizativa predeterminada para los objetos de equipo del dominio.

Tipo:String
Alias:OU
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PassThru

Devuelve un objeto que representa el elemento con el que está trabajando. De forma predeterminada, este cmdlet no genera ningún resultado.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Restart

Reinicia los equipos que se agregaron al dominio o grupo de trabajo. A menudo es necesario reiniciar para que el cambio surta efecto.

Este parámetro se incorporó en Windows PowerShell 3.0.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Server

Especifica el nombre de un controlador de dominio que agrega el equipo al dominio. Escriba el nombre en formato nombreDeDominio\nombreDeEquipo. De forma predeterminada, no se especifica ningún controlador de dominio.

Tipo:String
Alias:DC
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-UnjoinDomainCredential

Especifica una cuenta de usuario con permiso para quitar los equipos de sus dominios actuales. El valor predeterminado es el usuario actual.

Escriba un nombre de usuario, como "User01" o "Domain01\User01" o escriba un objeto PSCredential , como uno generado por el Get-Credential cmdlet. Si escribe un nombre de usuario, se le solicitará una contraseña.

Utilice este parámetro si va a mover equipos a un dominio diferente. Para especificar una cuenta de usuario que tenga permiso para unirse al nuevo dominio, use el parámetro Credential . Para especificar una cuenta de usuario que tenga permiso para conectarse a un equipo remoto, use el parámetro LocalCredential .

Este parámetro se incorporó en Windows PowerShell 3.0.

Tipo:PSCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Unsecure

Realiza una unión no segura al dominio especificado.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WorkgroupName

Especifica el nombre de un grupo de trabajo al que se agregan los equipos. El valor predeterminado es "GRUPO_DE_TRABAJO".

Tipo:String
Alias:WGN
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String

Puede canalizar los nombres de equipo y los nuevos nombres al Add-Computer cmdlet.

Salidas

ComputerChangeInfo

Cuando se usa el parámetro PassThru , Add-Computer devuelve un objeto ComputerChangeInfo . De lo contrario, este cmdlet no genera resultados.

Notas

  • En Windows PowerShell 2.0, se produce un error en el parámetro Add-Computer Server incluso cuando el servidor está presente. En Windows PowerShell 3.0, se cambia la implementación del parámetro Server para que funcione de forma confiable.