Add-Computer

Module:

Microsoft.PowerShell.Management Module

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

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

L’applet de commande Add-Computer ajoute l’ordinateur local ou les ordinateurs distants à un domaine ou un groupe de travail, ou les déplace d’un domaine à un autre. Il crée également un compte de domaine si l’ordinateur est ajouté au domaine sans compte.

Vous pouvez utiliser les paramètres de cette applet de commande pour spécifier une unité d’organisation (UO) et un contrôleur de domaine ou pour effectuer une jointure 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 -Restart

Cette commande ajoute l’ordinateur local au domaine Domain01, puis redémarre l’ordinateur pour effectuer la modification.

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

Add-Computer -WorkgroupName WORKGROUP-A

Cette 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 -Verbose

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

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. Il utilise le paramètre OUPath pour spécifier l’unité d’organisation pour les nouveaux comptes.

Exemple 5 : Ajouter un ordinateur local à un domaine à l’aide d’informations d’identification

$addComputerSplat = @{
    ComputerName = 'Server01'
    LocalCredential = 'Server01\Admin01'
    DomainName = 'Domain02'
    Credential = 'Domain02\Admin02'
    Restart = $true
    Force = $true
}
Add-Computer @addComputerSplat

Cette commande ajoute l’ordinateur Server01 au domaine Domain02. Il utilise le paramètre LocalCredential pour spécifier un compte d’utilisateur autorisé à se connecter à l’ordinateur Server01. Il utilise le paramètre Credential pour spécifier un compte d’utilisateur autorisé à joindre des ordinateurs au domaine. Il utilise le paramètre Redémarrer pour redémarrer l’ordinateur une fois l’opération de jointure terminée et le paramètre Forcer pour supprimer les messages de confirmation utilisateur.

Exemple 6 : Déplacer un groupe d’ordinateurs vers un nouveau domaine

$addComputerSplat = @{
    ComputerName = 'Server01', 'Server02', 'localhost'
    DomainName = 'Domain02'
    LocalCredential = 'Domain01\User01'
    UnjoinDomainCredential = 'Domain01\Admin01'
    Credential = 'Domain02\Admin01'
    Restart = $true
}
Add-Computer @addComputerSplat

Cette commande déplace les ordinateurs Server01 et Server02, ainsi que l’ordinateur local, de Domain01 à Domain02.

Il utilise le paramètre LocalCredential pour spécifier un compte d’utilisateur autorisé à se connecter aux trois ordinateurs affectés. Il utilise le paramètre unjoinDomainCredential pour spécifier un compte d’utilisateur autorisé à dissocier les ordinateurs du domaine Domain01 et le paramètre Credential pour spécifier un compte d’utilisateur autorisé à joindre les ordinateurs au domaine Domain02. Il utilise le paramètre Redémarrer 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

$addComputerSplat = @{
    ComputerName = 'Server01'
    DomainName = 'Domain02'
    NewName = 'Server044'
    Credential = 'Domain02\Admin01'
    Restart = $true
}
Add-Computer @addComputerSplat

Cette commande déplace l’ordinateur Server01 vers le domaine02 et remplace le nom de l’ordinateur par Server044.

La commande utilise les informations d’identification de l’utilisateur actuel pour se connecter à l’ordinateur Server01 et la disjoiner à partir 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

$addComputerSplat = @{
    ComputerName = (Get-Content Servers.txt)
    DomainName = 'Domain02'
    Credential = 'Domain02\Admin02'
    Options = 'Win9xUpgrade'
    Restart = $true
}
Add-Computer @addComputerSplat

Cette commande ajoute les ordinateurs répertoriés dans le Servers.txt fichier au domaine Domain02. Il utilise le paramètre options pour spécifier l’option Win9xUpgrade. Le paramètre Restart redémarre tous les ordinateurs nouvellement ajoutés une fois l’opération de jointure terminée.

Exemple 9 : Ajouter un ordinateur à un domaine à l’aide d’informations d’identification d’ordinateur prédéfinies

Cette première commande doit être exécutée par un administrateur à partir d’un ordinateur déjà joint au domaine Domain03:

$newADComputerSplat = @{
    Name = "Server02"
    AccountPassword = (ConvertTo-SecureString -String 'TempJoinPA$$' -AsPlainText -Force)
}
New-ADComputer @newADComputerSplat

# Then this command is run from `Server02` which is not yet domain-joined:

$joinCred = New-Object pscredential -ArgumentList ([pscustomobject]@{
    UserName = $null
    Password = (ConvertTo-SecureString -String 'TempJoinPA$$' -AsPlainText -Force)[0]
})
$addComputerSplat = @{
    DomainName = "Domain03"
    Options = 'UnsecuredJoin', 'PasswordPass'
    Credential = $joinCred
}
Add-Computer @addComputerSplat

Cette combinaison de commandes crée un compte d’ordinateur avec un nom prédéfini et un mot de passe de jointure temporaire dans un domaine à l’aide d’un ordinateur joint à un domaine existant. Ensuite, séparément, un ordinateur avec le nom prédéfini joint le domaine à l’aide uniquement du nom de l’ordinateur et du mot de passe de jointure temporaire. Le mot de passe prédéfini est utilisé uniquement pour prendre en charge l’opération de jointure et est remplacé dans le cadre des procédures de compte d’ordinateur normales une fois que l’ordinateur a terminé la jointure.

Exemple 10 : Ajouter un ordinateur à un domaine avec un nouveau nom

L’utilisation de cette combinaison de commandes évite plusieurs redémarrages et plusieurs écritures dans Active Directory pour le même objet lorsque l’ordinateur joint le domaine avec le nouveau nom.

Rename-Computer -NewName "MyNewPC" -Force
$addComputerSplat = @{
    DomainName = 'Contoso.com'
    Credential = 'contoso\administrator'
    Options = 'JoinWithNewName', 'AccountCreate'
}
Add-Computer @addComputerSplat

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

Type:	String[]
Valeur par défaut:	Local computer
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-Confirm

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

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	False
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	cf

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-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

Type:	PSCredential
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	DomainCredential

Jeux de paramètres

Domain

Position:	Named
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

Workgroup

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-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

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	DN, Domaine

Jeux de paramètres

Domain

Position:	0
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-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

Type:	SwitchParameter
Valeur par défaut:	False
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-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

Type:	PSCredential
Valeur par défaut:	Current user
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	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.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-Options

Spécifie les options avancées pour l’opération de Add-Computer jointure. 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’il 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. Si vous souhaitez passer un mot de passe d’ordinateur, vous devez utiliser cette option en combinaison avec PasswordPass l’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. Lorsque vous utilisez cette option, les informations d’identification fournies au -Credential paramètre doivent avoir un nom d’utilisateur Null.

• 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 ne redémarrez pas l’ordinateur pour effectuer la modification, 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 la méthode JoinDomainOrWorkgroup de la classe Win32_ComputerSystem. Pour plus d’informations sur ces options, consultez la fonction NetJoinDomain.

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

Propriétés du paramètre

Type:	JoinOptions
Valeur par défaut:	None
Valeurs acceptées:	AccountCreate, Win9XUpgrade, UnsecuredJoin, PasswordPass, DeferSPNSet, JoinWithNewName, JoinReadOnly, InstallInvoke
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

Domain

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-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

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	Unité d’organisation

Jeux de paramètres

Domain

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-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

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	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 rendre la modification effective.

Ce paramètre est introduit dans Windows PowerShell 3.0.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	False
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Server

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

À compter d’août 2024, le renforcement de la sécurité pour la jonction de domaine nécessite l’utilisation du nom de domaine complet du contrôleur de domaine. Par exemple : DC1.contoso.com. Pour plus d’informations, consultez Modifications de renforcement de la jonction de domaine NetJoin.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	DC

Jeux de paramètres

Domain

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-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

Type:	PSCredential
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

Domain

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Unsecure

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

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

Domain

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-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

Type:	SwitchParameter
Valeur par défaut:	False
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	Wi

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-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

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	WGN

Jeux de paramètres

Workgroup

Position:	0
Obligatoire:	True
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

String

Vous pouvez diriger les noms d’ordinateurs et les nouveaux noms vers l’applet de commande Add-Computer.

Sorties

ComputerChangeInfo

Lorsque vous utilisez le paramètre PassThru , 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 afin qu’il fonctionne de manière fiable.

Liens associés

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