Add-Computer

Syntaxe

Domain (Par défaut)

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

Exemples

Exemple 1 : Ajouter un ordinateur local à un domaine, puis redémarrer l’ordinateur

Add-Computer -DomainName Domain01 -Restart

Exemple 2 : Ajouter un ordinateur local à un groupe de travail

Add-Computer -WorkgroupName WORKGROUP-A

Exemple 3 : Ajouter un ordinateur local à un domaine

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

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"

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

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

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

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

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

Ce paramètre est introduit dans Windows PowerShell 3.0.

Propriétés du paramètre

Jeux de paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Jeux de paramètres

-Credential

Spécifie un compte d’utilisateur autorisé à 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 qu’un objet généré par l’applet de commande Get-Credential. Si vous tapez un nom d’utilisateur, vous serez invité à entrer un mot de passe.

Pour spécifier un compte d’utilisateur autorisé à supprimer l’ordinateur de son domaine actuel, utilisez le paramètre UnjoinDomainCredential. Pour spécifier un compte d’utilisateur autorisé à se connecter à un ordinateur distant, utilisez le paramètre LocalCredential.

Propriétés du paramètre

Jeux de paramètres

-DomainName

Spécifie le domaine auquel les ordinateurs sont ajoutés. Ce paramètre est requis lors de l’ajout des ordinateurs à un domaine.

Propriétés du paramètre

Jeux de paramètres

-Force

Supprime l’invite de confirmation de l’utilisateur. Sans ce paramètre, Add-Computer vous oblige à confirmer l’ajout de chaque ordinateur.

Ce paramètre est introduit dans Windows PowerShell 3.0.

Propriétés du paramètre

Jeux de paramètres

-LocalCredential

Spécifie un compte d’utilisateur autorisé à 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 qu’un objet généré par l’applet de commande Get-Credential. Si vous tapez un nom d’utilisateur, vous serez invité à entrer un mot de passe.

Pour spécifier un compte d’utilisateur autorisé à ajouter les ordinateurs à un nouveau domaine, utilisez le paramètre Credential. Pour spécifier un compte d’utilisateur autorisé à supprimer les ordinateurs de leur domaine actuel, utilisez le paramètre UnjoinDomainCredential.

Ce paramètre est introduit dans Windows PowerShell 3.0.

Propriétés du paramètre

Jeux de paramètres

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

Propriétés du paramètre

Jeux de paramètres

-Options

Spécifie les options avancées pour l’opération de jonction Ajouter-Ordinateur . Entrez une ou plusieurs valeurs dans une chaîne séparée par des virgules.

Les valeurs acceptables pour ce paramètre sont les suivantes :

• 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 non sécurisé 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 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 le 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 le redémarrez pas 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é vers le contrôleur de domaine en lecture seule avant l’opération de jointure.

• InstallInvoke: définit les indicateurs de création (0x2) et de suppression (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 fonction NetJoinDomain dans la bibliothèque MSDN.

Ce paramètre a été introduit dans Windows PowerShell 3.0.

Propriétés du paramètre

Jeux de paramètres

-OUPath

Spécifie une unité d’organisation (UO) 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 pour les objets d’ordinateur dans le domaine.

Propriétés du paramètre

Jeux de paramètres

-PassThru

Retourne un objet représentant l’élément avec lequel vous travaillez. Par défaut, cette applet de commande ne génère aucune sortie.

Propriétés du paramètre

Jeux de paramètres

-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 rendre la modification effective.

Ce paramètre est introduit dans Windows PowerShell 3.0.

Propriétés du paramètre

Jeux de paramètres

-Server

Spécifie le nom d’un contrôleur de domaine qui ajoute l’ordinateur au domaine. Entrez le nom au format DomainName\ComputerName. Par défaut, aucun contrôleur de domaine n’est spécifié.

Propriétés du paramètre

Jeux de paramètres

-UnjoinDomainCredential

Spécifie un compte d’utilisateur autorisé à 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 qu’un objet généré par l’applet de commande Get-Credential. Si vous tapez un nom d’utilisateur, vous serez 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 autorisé à joindre le nouveau domaine, utilisez le paramètre Credential. Pour spécifier un compte d’utilisateur autorisé à se connecter à un ordinateur distant, utilisez le paramètre LocalCredential.

Ce paramètre est introduit dans Windows PowerShell 3.0.

Propriétés du paramètre

Jeux de paramètres

-Unsecure

Effectue une jointure non sécurisée au domaine spécifié.

Propriétés du paramètre

Jeux de paramètres

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Jeux de paramètres

-WorkgroupName

Spécifie le nom d’un groupe de travail auquel les ordinateurs sont ajoutés. La valeur par défaut est « WORKGROUP ».

Propriétés du paramètre

Jeux de paramètres

CommonParameters

Entrées

String

Sorties

ComputerChangeInfo

Notes

Liens associés

• Checkpoint-Computer
• Remove-Computer
• Redémarrer-l'ordinateur
• Rename-Computer
• Restaurer l'ordinateur
• Stop-Computer
• Test-Connection