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

Sintaxis

Add-Computer [-DomainName] <string> [-Credential <PSCredential>] [-OUPath <string>] [-Server <string>] [-Unsecure] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Add-Computer [-WorkGroupName] <string> [-Credential <PSCredential>] [-PassThru] [-Confirm] [-WhatIf] [<CommonParameters>]

Descripción

El cmdlet Add-Computer agrega el equipo local a un dominio o grupo de trabajo, o lo 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 un controlador de dominio o para realizar una unión no segura.

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

Parámetros

-Credential <PSCredential>

Especifica una cuenta de usuario con permiso para realizar esta acción. El valor predeterminado es el usuario actual.

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

¿Requerido?

false

¿Posición?

named

Valor predeterminado

Current User Account Credentials

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-DomainName <string>

Especifica un dominio para la cuenta de equipo. Este parámetro es obligatorio.

¿Requerido?

true

¿Posición?

2

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-OUPath <string>

Especifica una unidad organizativa para la cuenta de dominio. Escriba el nombre completo de la unidad organizativa. El valor predeterminado es la unidad organizativa predeterminada para los objetos de equipo en el dominio.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

The default OU for machine objects for in the domain

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-PassThru

Devuelve los resultados del comando. De forma predeterminada, este cmdlet no genera resultados.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Server <string>

Especifica el nombre de un controlador de dominio que agrega el equipo al dominio. Escriba el nombre en el formato nombreDeDominio\nombreDeEquipo. El valor predeterminado es el equipo local.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Unsecure

Realiza una unión no segura.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-WorkGroupName <string>

Especifica el nombre de un grupo de trabajo para el equipo. Si omite este parámetro, el equipo se une a un dominio.

¿Requerido?

true

¿Posición?

3

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Confirm

Solicita confirmación antes de ejecutar el comando.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-WhatIf

Describe lo que ocurriría si ejecutara el comando sin ejecutarlo realmente.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.

Entradas y salidas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.

Entradas

Ninguno

No se pueden canalizar objetos a Add-Computer.

Salidas

Microsoft.PowerShell.Commands.ComputerChangeInfo

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

Ejemplo 1

C:\PS>add-computer -domainname Domain01; restart-computer

Descripción
-----------
Estos comandos agregan el equipo local al dominio Domain01 utilizando las credenciales del usuario actual.

El primer comando agrega el equipo al dominio. El segundo comando usa el cmdlet Restart-Computer para reiniciar el equipo, con lo que se completa la operación de unión. El signo de punto y coma (;) separa los dos comandos.






Ejemplo 2

C:\PS>add-computer -workgroupname WORKGROUP-A

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






Ejemplo 3

C:\PS>add-computer -DomainName Domain01 -Server Domain01\DC01 -passthru -verbose

Descripción
-----------
Este comando agrega el equipo local al dominio Domain01 utilizando el controlador de dominio Domain01\DC01. 

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






Ejemplo 4

C:\PS>Add-Computer -domainname Domain02 -OUPath OU=testOU,DC=domain,DC=Domain,DC=com

Descripción
-----------
Este comando agrega los equipos Server01 y Server02 al dominio Domain02. Utiliza el comando OUPath para especificar la unidad organizativa para las nuevas cuentas.






Ejemplo 5

C:\PS>Add-Computer -domainname Domain02 -cred Domain02\Admin02 -passthru

Descripción
-----------
Este comando agrega el equipo local al dominio Domain02 utilizando las credenciales de un administrador de dominio. El comando utiliza el parámetro PassThru para generar un informe breve sobre los resultados del comando.






Vea también




Tabla de contenido