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