Add-Computer

Ajoutez l'ordinateur local à un domaine ou à un groupe de travail.

Syntaxe

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

Description

L'applet de commande Add-Computer ajoute l'ordinateur local à un domaine ou à un groupe de travail ou le déplace d'un domaine vers un autre. Elle crée également un compte de domaine si l'ordinateur est ajouté sans compte au domaine.

Vous pouvez utiliser les paramètres de cette applet de commande pour spécifier une unité d'organisation (OU, Organizational Unit) et un contrôleur de domaine ou exécuter une jointure non sécurisée.

Pour obtenir les résultats de la commande, utilisez les paramètres Verbose et PassThru.

Paramètres

-Credential <PSCredential>

Spécifie un compte d'utilisateur qui a l'autorisation d'exécuter cette action. La valeur par défaut est l'utilisateur actuel.

Tapez un nom d'utilisateur, tel que « User01 » ou « Domain01\User01 », ou entrez un objet PSCredential, tel que celui généré par l'applet de commande Get-Credential. Si vous tapez un nom d'utilisateur, vous êtes invité à entrer un mot de passe.

Obligatoire ?	false
Position ?	named
Valeur par défaut	Current User Account Credentials
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-DomainName <string>

Spécifie un domaine pour le compte d'ordinateur. Ce paramètre est obligatoire.

Obligatoire ?	true
Position ?	2
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-OUPath <string>

Spécifie une unité d'organisation pour le compte de domaine. Entrez le nom unique complet de l'unité d'organisation. La valeur par défaut est l'unité d'organisation par défaut des objets ordinateur du domaine.

Obligatoire ?	false
Position ?	named
Valeur par défaut	The default OU for machine objects for in the domain
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-PassThru

Retourne les résultats de la commande. Par défaut, cette applet de commande ne génère aucune sortie.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-Server <string>

Spécifie le nom d'un contrôleur de domaine qui ajoute l'ordinateur au domaine. Entrez le nom sous la forme DomainName\ComputerName. La valeur par défaut est l'ordinateur local.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-Unsecure

Exécute une jointure non sécurisée.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-WorkGroupName <string>

Spécifie le nom d'un groupe de travail pour l'ordinateur. Si vous omettez ce paramètre, l'ordinateur est joint à un domaine.

Obligatoire ?	true
Position ?	3
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-Confirm

Vous invite à confirmer l'exécution de la commande.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-WhatIf

Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.

Entrées et sorties

Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.

Entrées	None Vous ne pouvez pas diriger d'objets vers Add-Computer.
Sorties	Microsoft.PowerShell.Commands.ComputerChangeInfo Lorsque vous utilisez le paramètre PassThru, Add-Computer retourne un objet ComputerChangeInfo. Sinon, cette applet de commande ne génère aucune sortie.

Exemple 1

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

Description
-----------
Ces commandes ajoutent l'ordinateur local au domaine Domain01 à l'aide des informations d'identification de l'utilisateur actuel.

La première commande ajoute l'ordinateur au domaine. La seconde commande utilise l'applet de commande Restart-Computer pour redémarrer l'ordinateur, ce qui complète l'opération de jointure. Le point-virgule (;) sépare deux commandes.

Exemple 2

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

Description
-----------
Cette commande ajoute l'ordinateur local au groupe de travail Workgroup-A.

Exemple 3

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

Description
-----------
Cette commande ajoute l'ordinateur local au domaine Domain01 à l'aide du contrôleur de domaine Domain01\DC01. 

La commande utilise les paramètres PassThru et Verbose pour obtenir des informations détaillées sur les résultats de la commande.

Exemple 4

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

Description
-----------
Cette commande ajoute les ordinateurs Server01 et Server02 au domaine Domain02. Elle utilise la commande OUPath pour spécifier l'unité d'organisation des nouveaux comptes.

Exemple 5

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

Description
-----------
Cette commande ajoute l'ordinateur local au domaine Domain02 à l'aide des informations d'identification d'un administrateur de domaine. La commande utilise le paramètre PassThru pour générer un rapport sommaire sur les résultats de la commande.

Voir aussi

Concepts

Checkpoint-Computer
Remove-Computer
Restart-Computer
Restore-Computer
Stop-Computer
Test-Connection