Add-Computer

Referencia

Módulo:: Microsoft.PowerShell.Management

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

Syntax

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 usando el controlador de dominio Domain01\DC01.

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

Add-Computer -ComputerName Server01 -LocalCredential Server01\Admin01 -DomainName Domain02 -Credential Domain02\Admin02 -Restart -Force

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

Add-Computer -ComputerName Server01, Server02, localhost -DomainName Domain02 -LocalCredential Domain01\User01 -UnjoinDomainCredential Domain01\Admin01 -Credential Domain02\Admin01 -Restart

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

Add-Computer -ComputerName Server01 -DomainName Domain02 -NewName Server044 -Credential Domain02\Admin01 -Restart

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

Add-Computer -ComputerName (Get-Content Servers.txt) -DomainName Domain02 -Credential Domain02\Admin02 -Options Win9xUpgrade  -Restart

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:

New-ADComputer -Name "Server02" -AccountPassword (ConvertTo-SecureString -String 'TempJoinPA$$' -AsPlainText -Force)

# 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]
})
Add-Computer -Domain "Domain03" -Options UnsecuredJoin,PasswordPass -Credential $joinCred

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.

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.

Type:	String[]
Position:	Named
Default value:	Local computer
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 .

Type:	PSCredential
Aliases:	DomainCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DomainName

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

Type:	String
Aliases:	DN, Domain
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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.

Type:	PSCredential
Position:	Named
Default value:	Current user
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	JoinOptions
Accepted values:	AccountCreate, Win9XUpgrade, UnsecuredJoin, PasswordPass, DeferSPNSet, JoinWithNewName, JoinReadOnly, InstallInvoke
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Aliases:	OU
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Aliases:	DC
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UnjoinDomainCredential

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

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.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Unsecure

Realiza una unión no segura al dominio especificado.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WorkgroupName

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

Type:	String
Aliases:	WGN
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Add-Computer

Syntax

Description

Ejemplos

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

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

Ejemplo 3: Agregar un equipo local a un dominio

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

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

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

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

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

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

Parámetros

-ComputerName

-Confirm

-Credential

-DomainName

-Force

-LocalCredential

-NewName

-Options

-OUPath

-PassThru

-Restart

-Server

-UnjoinDomainCredential

-Unsecure

-WhatIf

-WorkgroupName

Entradas

Salidas

Notas

Comentarios

Recursos adicionales

Add-Computer

Syntax

Description

Ejemplos

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

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

Ejemplo 3: Agregar un equipo local a un dominio

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

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

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

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

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

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

Parámetros

-ComputerName

-Confirm

-Credential

-DomainName

-Force

-LocalCredential

-NewName

-Options

-OUPath

-PassThru

-Restart

-Server

-UnjoinDomainCredential

-Unsecure

-WhatIf

-WorkgroupName

Entradas

Salidas

Notas

Vínculos relacionados

Comentarios

Recursos adicionales