Add-Computer
Ajoutez l’ordinateur local à un domaine ou à un groupe de travail.
Syntax
Add-Computer
[-ComputerName <String[]>]
[-LocalCredential <PSCredential>]
[-UnjoinDomainCredential <PSCredential>]
-Credential <PSCredential>
[-DomainName] <String>
[-OUPath <String>]
[-Server <String>]
[-Unsecure]
[-Options <JoinOptions>]
[-Restart]
[-PassThru]
[-NewName <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Add-Computer
[-ComputerName <String[]>]
[-LocalCredential <PSCredential>]
[-Credential <PSCredential>]
[-WorkgroupName] <String>
[-Restart]
[-PassThru]
[-NewName <String>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
L’applet Add-Computer de commande ajoute l’ordinateur local ou les ordinateurs distants à un domaine ou à un groupe de travail, ou les déplace d’un domaine à 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 pour exécuter une jonction non sécurisée.
Pour obtenir les résultats de la commande, utilisez les paramètres Verbose et PassThru.
Exemples
Exemple 1 : Ajouter un ordinateur local à un domaine, puis redémarrer l’ordinateur
Add-Computer -DomainName Domain01 -RestartCette commande ajoute l’ordinateur local au domaine Domain01, puis redémarre l’ordinateur pour que le changement devienne effectif.
Exemple 2 : Ajouter un ordinateur local à un groupe de travail
Add-Computer -WorkgroupName WORKGROUP-ACette commande ajoute l’ordinateur local au groupe de travail Workgroup-A.
Exemple 3 : Ajouter un ordinateur local à un domaine
Add-Computer -DomainName Domain01 -Server Domain01\DC01 -PassThru -VerboseCette 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 : Ajouter un ordinateur local à un domaine à l’aide du paramètre OUPath
Add-Computer -DomainName Domain02 -OUPath "OU=testOU,DC=domain,DC=Domain,DC=com"Cette commande ajoute l’ordinateur local au domaine Domain02. Elle utilise le paramètre OUPath pour spécifier l’unité d’organisation des nouveaux comptes.
Exemple 5 : Ajouter un ordinateur local à un domaine à l’aide d’informations d’identification
Add-Computer -ComputerName Server01 -LocalCredential Server01\Admin01 -DomainName Domain02 -Credential Domain02\Admin02 -Restart -ForceCette commande ajoute l’ordinateur Server01 au domaine Domain02. Elle utilise le paramètre LocalCredential pour spécifier un compte d’utilisateur qui a l’autorisation de se connecter à l’ordinateur Server01. Elle utilise le paramètre Credential pour spécifier un compte d’utilisateur qui a l’autorisation de joindre des ordinateurs au domaine. Elle utilise le paramètre Restart pour redémarrer l’ordinateur à la fin de l’opération de jonction et le paramètre Force pour supprimer les messages de confirmation de l’utilisateur.
Exemple 6 : Déplacer un groupe d’ordinateurs vers un nouveau domaine
Add-Computer -ComputerName Server01, Server02, localhost -DomainName Domain02 -LocalCredential Domain01\User01 -UnjoinDomainCredential Domain01\Admin01 -Credential Domain02\Admin01 -RestartCette commande déplace les ordinateurs Server01 et Server02, et l’ordinateur local, de Domain01 vers Domain02.
Elle utilise le paramètre LocalCredential pour spécifier un compte d’utilisateur qui a l’autorisation de se connecter aux trois ordinateurs concernés. Elle utilise le paramètre UnjoinDomainCredential pour spécifier un compte d’utilisateur qui a l’autorisation de disjoindre les ordinateurs du domaine Domain01 et le paramètre Credential pour spécifier un compte d’utilisateur qui a l’autorisation de joindre les ordinateurs au domaine Domain02. Elle utilise le paramètre Restart pour redémarrer les trois ordinateurs une fois le déplacement terminé.
Exemple 7 : Déplacer un ordinateur vers un nouveau domaine et modifier le nom de l’ordinateur
Add-Computer -ComputerName Server01 -DomainName Domain02 -NewName Server044 -Credential Domain02\Admin01 -RestartCette commande déplace l’ordinateur Server01 vers le domaine Domain02 et remplace le nom d’ordinateur par Server044.
La commande utilise les informations d’identification de l’utilisateur actuel pour se connecter à l’ordinateur Server01 et le disjoindre de son domaine actuel. Il utilise le paramètre Credential pour spécifier un compte d’utilisateur autorisé à joindre l’ordinateur au domaine Domain02.
Exemple 8 : Ajouter des ordinateurs répertoriés dans un fichier à un nouveau domaine
Add-Computer -ComputerName (Get-Content Servers.txt) -DomainName Domain02 -Credential Domain02\Admin02 -Options Win9xUpgrade -RestartCette commande ajoute les ordinateurs qui sont répertoriés dans le fichier Servers.txt au domaine Domain02. Elle utilise le paramètre Options pour spécifier l’option Win9xUpgrade. Le paramètre Restart redémarre tous les ordinateurs nouvellement ajoutés à la fin de l'opération de jonction.
Paramètres
-ComputerName
Spécifie les ordinateurs à ajouter à un domaine ou à un groupe de travail. La valeur par défaut est l'ordinateur local.
Tapez le nom NetBIOS, une adresse IP (Internet Protocol) ou un nom de domaine complet de chacun des ordinateurs distants. Pour spécifier l'ordinateur local, tapez le nom de l'ordinateur, un point (.) ou « localhost ».
Ce paramètre ne s'appuie pas sur la communication à distance Windows PowerShell.
Vous pouvez utiliser le paramètre ComputerName de Add-Computer même si votre ordinateur n’est pas configuré pour exécuter des commandes à distance.
Ce paramètre est introduit dans Windows PowerShell 3.0.
| Type: | String[] |
| Position: | Named |
| Default value: | Local computer |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Spécifie un compte d’utilisateur qui a l’autorisation de joindre les ordinateurs à un nouveau domaine. 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.
Pour spécifier un compte d’utilisateur qui a l’autorisation de supprimer l’ordinateur de son domaine actuel, utilisez le paramètre UnjoinDomainCredential. Pour spécifier un compte d’utilisateur qui a l’autorisation de se connecter à un ordinateur distant, utilisez le paramètre LocalCredential.
| Type: | PSCredential |
| Aliases: | DomainCredential |
| Position: | Named |
| Default value: | Current User Account Credentials |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DomainName
Spécifie le domaine auquel les ordinateurs sont ajoutés. Ce paramètre est obligatoire lors de l’ajout des ordinateurs à un domaine.
| Type: | String |
| Aliases: | DN, Domain |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
Supprime la demande de confirmation de l’utilisateur.
Sans ce paramètre, Add-Computer vous devez confirmer l’ajout de chaque ordinateur.
Ce paramètre est introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LocalCredential
Spécifie un compte d’utilisateur qui a l’autorisation de se connecter aux ordinateurs spécifiés par le paramètre ComputerName. 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.
Pour spécifier un compte d’utilisateur qui a l’autorisation d’ajouter les ordinateurs à un nouveau domaine, utilisez le paramètre Credential. Pour spécifier un compte d’utilisateur qui a l’autorisation de supprimer les ordinateurs de leur domaine actuel, utilisez le paramètre UnjoinDomainCredential.
Ce paramètre est introduit dans Windows PowerShell 3.0.
| Type: | PSCredential |
| Position: | Named |
| Default value: | Current user |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NewName
Spécifie un nouveau nom pour l’ordinateur dans le nouveau domaine. Ce paramètre n’est valide que lorsqu’un ordinateur est ajouté ou déplacé.
Ce paramètre est introduit dans Windows PowerShell 3.0.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Options
Spécifie des options avancées pour l’opération de jointure Add-Computer . Entrez une ou plusieurs valeurs dans une chaîne séparée par des virgules.
Les valeurs valides pour ce paramètre sont :
AccountCreate : crée un compte de domaine. L’applet de commande Add-Computer crée automatiquement un compte de domaine lorsqu’elle ajoute un ordinateur à un domaine. Cette option est incluse pour l’exhaustivité.
Win9XUpgrade : indique que l’opération de jointure fait partie d’une mise à niveau du système d’exploitation Windows.
UnsecuredJoin : effectue une jointure non sécurisée. Pour demander une jointure non sécurisée, utilisez le paramètre Unsecure ou cette option.
PasswordPass : définit le mot de passe de l’ordinateur sur la valeur du paramètre Credential(DomainCredential) après avoir effectué une jointure non sécurisée. Cette option indique également que la valeur du paramètre Credential (DomainCredential) est un mot de passe d’ordinateur et non un mot de passe d’utilisateur. Cette option est valide uniquement lorsque l'option UnsecuredJoin est spécifiée.
-- JoinWithNewName : renomme le nom de l’ordinateur dans le nouveau domaine en nom spécifié par le paramètre NewName . Lorsque vous utilisez le paramètre NewName, cette option est définie automatiquement. Cette option est conçue pour être utilisée avec l’applet de commande Rename-Computer. Si vous utilisez l’applet de commande Rename-Computer pour renommer l’ordinateur, mais que vous ne redémarrez pas l’ordinateur pour que la modification soit effective, vous pouvez utiliser ce paramètre pour joindre l’ordinateur à un domaine portant son nouveau nom.
JoinReadOnly : utilise un compte d’ordinateur existant pour joindre l’ordinateur à un contrôleur de domaine en lecture seule. Le compte d’ordinateur doit être ajouté à la liste autorisée pour la stratégie de réplication de mot de passe et le mot de passe du compte doit être répliqué sur le contrôleur de domaine en lecture seule avant l’opération de jointure.
InstallInvoke : définit les indicateurs create (0x2) et delete (0x4) du paramètre FJoinOptions de la méthode JoinDomainOrWorkgroup . Pour plus d’informations sur la méthode JoinDomainOrWorkgroup , consultez Méthode JoinDomainOrWorkgroup de la classe Win32_ComputerSystem dans la bibliothèque MSDN. Pour plus d’informations sur ces options, consultez La fonction NetJoinDomain dans la bibliothèque MSDN.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
| Type: | JoinOptions |
| Accepted values: | AccountCreate, Win9XUpgrade, UnsecuredJoin, PasswordPass, DeferSPNSet, JoinWithNewName, JoinReadOnly, InstallInvoke |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OUPath
Spécifie une unité d’organisation pour le compte de domaine. Entrez le nom unique complet de l’unité d’organisation entre guillemets. La valeur par défaut est l’unité d’organisation par défaut des objets ordinateur du domaine.
| Type: | String |
| Aliases: | OU |
| Position: | Named |
| Default value: | The default OU for machine objects for in the domain |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
Retourne un objet représentant l’élément que vous utilisez. Par défaut, cette applet de commande ne génère aucun résultat.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Restart
Redémarre les ordinateurs qui ont été ajoutés au domaine ou au groupe de travail. Un redémarrage est souvent nécessaire pour que le changement devienne effectif.
Ce paramètre est introduit dans Windows PowerShell 3.0.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Server
Spécifie le nom d’un contrôleur de domaine qui ajoute l’ordinateur au domaine. Entrez le nom sous la forme DomainName\ComputerName. Par défaut, aucun contrôleur de domaine n’est spécifié.
| Type: | String |
| Aliases: | DC |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UnjoinDomainCredential
Spécifie un compte d’utilisateur qui a l’autorisation de supprimer les ordinateurs de leurs domaines actuels. 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.
Utilisez ce paramètre lorsque vous déplacez des ordinateurs vers un autre domaine. Pour spécifier un compte d’utilisateur qui a l’autorisation de joindre le nouveau domaine, utilisez le paramètre Credential. Pour spécifier un compte d’utilisateur qui a l’autorisation de se connecter à un ordinateur distant, utilisez le paramètre LocalCredential.
Ce paramètre est introduit dans Windows PowerShell 3.0.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Unsecure
Exécute une jonction non sécurisée au domaine spécifié.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WorkgroupName
Spécifie le nom d'un groupe de travail auquel les ordinateurs sont ajoutés. La valeur par défaut est « WORKGROUP ».
| Type: | String |
| Aliases: | WGN |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entrées
Vous pouvez diriger des noms d’ordinateurs et de nouveaux noms vers l’applet de Add-Computer commande.
Sorties
Lorsque vous utilisez le paramètre PassThru , Add-Computer retourne un objet ComputerChangeInfo .
Sinon, cette applet de commande ne génère aucune sortie.
Notes
- Dans Windows PowerShell 2.0, le paramètre Server de
Add-Computeréchoue même lorsque le serveur est présent. Dans Windows PowerShell 3.0, l’implémentation du paramètre Server est modifiée pour qu’il fonctionne de façon fiable.