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