Add-Computer

Sintaxis

Domain (valor predeterminado)

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

Workgroup

Add-Computer
    [-WorkgroupName] <String>
    [-ComputerName <String[]>]
    [-LocalCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Restart]
    [-PassThru]
    [-NewName <String>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Ejemplos

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

Add-Computer -DomainName Domain01 -Restart

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

Add-Computer -WorkgroupName WORKGROUP-A

Ejemplo 3: Agregar un equipo local a un dominio

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

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"

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

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

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

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

Parámetros

-ComputerName

Especifica los equipos que se van a agregar a un dominio o grupo de trabajo. El valor predeterminado es el equipo local.

Escriba el nombre NetBIOS, una dirección IP (Protocolo de Internet) 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 se basa en la comunicación remota de Windows PowerShell. Puede usar el parámetro ComputerName de Add-Computer incluso si el equipo no está configurado para ejecutar comandos remotos.

Este parámetro se presenta en Windows PowerShell 3.0.

Propiedades de parámetro

Conjuntos de parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Conjuntos de parámetros

-Credential

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

Escriba un nombre de usuario, como "User01" o "Domain01\User01", o escriba un objeto de PSCredential, como uno generado por el cmdlet Get-Credential. Si escribe un nombre de usuario, se le pedirá 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.

Propiedades de parámetro

Conjuntos de parámetros

-DomainName

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

Propiedades de parámetro

Conjuntos de parámetros

-Force

Suprime el mensaje de confirmación del usuario. Sin este parámetro, Add-Computer requiere que confirme la adición de cada equipo.

Este parámetro se presenta en Windows PowerShell 3.0.

Propiedades de parámetro

Conjuntos de parámetros

-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 de PSCredential, como uno generado por el cmdlet Get-Credential. Si escribe un nombre de usuario, se le pedirá 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 presenta en Windows PowerShell 3.0.

Propiedades de parámetro

Conjuntos de parámetros

-NewName

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

Este parámetro se presenta en Windows PowerShell 3.0.

Propiedades de parámetro

Conjuntos de parámetros

-Options

Especifica las opciones avanzadas para la operación de combinación Agregar equipo . Escriba uno o varios valores en una cadena separada por comas.

Los valores aceptables para este parámetro son:

• cuentaCrear: crea una cuenta de dominio. El cmdlet Agregar equipo 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.

• 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 opción UnsecuredJoin.

-- JoinWithNewName: cambia el nombre del equipo en el 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 Rename-Computer para cambiar el 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 de , vea método JoinDomainOrWorkgroup de la clase Win32_ComputerSystem en MSDN Library. Para obtener más información sobre estas opciones, consulte función NetJoinDomain en MSDN Library.

Este parámetro se introdujo en Windows PowerShell 3.0.

Propiedades de parámetro

Conjuntos de parámetros

-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.

Propiedades de parámetro

Conjuntos de parámetros

-PassThru

Devuelve un objeto que representa el elemento con el que está trabajando. De forma predeterminada, este cmdlet no genera ninguna salida.

Propiedades de parámetro

Conjuntos de parámetros

-Restart

Reinicia los equipos que se agregaron al dominio o al grupo de trabajo. A menudo, se requiere un reinicio para hacer que el cambio sea efectivo.

Este parámetro se presenta en Windows PowerShell 3.0.

Propiedades de parámetro

Conjuntos de parámetros

-Server

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

Propiedades de parámetro

Conjuntos de parámetros

-UnjoinDomainCredential

Especifica una cuenta de usuario que tiene 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 de PSCredential, como uno generado por el cmdlet Get-Credential. Si escribe un nombre de usuario, se le pedirá una contraseña.

Use este parámetro cuando mueva equipos a otro dominio. 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 presenta en Windows PowerShell 3.0.

Propiedades de parámetro

Conjuntos de parámetros

-Unsecure

Realiza una unión no segura al dominio especificado.

Propiedades de parámetro

Conjuntos de parámetros

-WhatIf

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

Propiedades de parámetro

Conjuntos de parámetros

-WorkgroupName

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

Propiedades de parámetro

Conjuntos de parámetros

CommonParameters

Entradas

String

Salidas

ComputerChangeInfo

Notas

Vínculos relacionados

• Checkpoint-Computer
• Remove-Computer
• Restart-Computer
• Rename-Computer
• Restore-Computer
• Stop-Computer
• Test-Connection (Prueba de conexión)