Add-Computer

Syntaxe

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

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

$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 Restart pour redémarrer l’ordinateur une fois l’opération de jointure terminée et le paramètre Force 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, et l’ordinateur local, de Domain01 vers 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 qui a l’autorisation de dissocier les ordinateurs du domaine Domain01 et du paramètre Credential pour spécifier un compte d’utilisateur autorisé à joindre les ordinateurs au domaine Domain02. Il 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

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

Cette 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

$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

-Confirm

-Credential

-DomainName

-Force

-LocalCredential

-NewName

-Options

-OUPath

-PassThru

-Restart

-Server

-UnjoinDomainCredential

-Unsecure

-WhatIf

-WorkgroupName

Entrées

String

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

Sorties

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.

Notes

• Dans Windows PowerShell 2.0, le paramètre serveur d’échecs Add-Computer même lorsque le serveur est présent. Dans Windows PowerShell 3.0, l’implémentation du paramètre Serveur est modifiée afin qu’elle fonctionne de manière fiable.

Liens associés

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