Add-Computer

NOM
    Add-Computer

RÉSUMÉ
    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                     Informations d'identification du compte d'utilisateur actuel
        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                     Unité d'organisation par défaut des objets ordinateur du domaine
        Accepter l'entrée de pipeline ?       false
        Accepter les caractères génériques ?  false

    -PassThru [<SwitchParameter>]
        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 [<SwitchParameter>]
        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 [<SwitchParameter>]
        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 [<SwitchParameter>]
        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, WarningAction, WarningVariable,
        OutBuffer et OutVariable. Pour plus d'informations, tapez
        « get-help about_commonparameters ».

ENTRÉES
    Aucun
        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.


NOTES





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






LIENS CONNEXES
    Online version: http://go.microsoft.com/fwlink/?LinkID=135194
    Checkpoint-Computer
    Remove-Computer
    Restart-Computer
    Restore-Computer
    Stop-Computer
    Test-Connection