Remove-Computer
Supprime l’ordinateur local de son domaine.
Syntaxe
Local (Par défaut)
Remove-Computer
[[-UnjoinDomainCredential] <PSCredential>]
[-Restart]
[-Force]
[-PassThru]
[-WorkgroupName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remote
Remove-Computer
-UnjoinDomainCredential <PSCredential>
[-LocalCredential <PSCredential>]
[-Restart]
[-ComputerName <String[]>]
[-Force]
[-PassThru]
[-WorkgroupName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Remove-Computer supprime l’ordinateur local et les ordinateurs distants de leurs domaines actuels.
Lorsque vous supprimez un ordinateur d’un domaine, Remove-Computer désactive également le compte de domaine de l’ordinateur. Vous devez fournir des informations d’identification explicites pour dissocier l’ordinateur de son domaine, même s’ils sont les informations d’identification de l’utilisateur actuel. Vous devez redémarrer l’ordinateur pour que la modification soit effective. En outre, lorsque vous supprimez un ordinateur d’un domaine, vous devez le déplacer vers un groupe de travail. Utilisez le paramètre WorkgroupName pour spécifier le groupe de travail.
Pour déplacer un ordinateur d’un groupe de travail vers un domaine, d’un groupe de travail à un autre ou d’un domaine à un autre, utilisez l’applet de commande Add-Computer.
Pour obtenir les résultats de la commande, utilisez les paramètres Verbose et PassThru. Pour supprimer l’invite de l’utilisateur, utilisez le paramètre force.
Remove-Computer supprime l’ordinateur local et les ordinateurs distants des domaines. Il inclut des paramètres d’informations d’identification qui spécifient d’autres informations d’identification pour la connexion à des ordinateurs distants et la disjoint à partir d’un domaine, un paramètre Redémarrer pour redémarrer les ordinateurs concernés et un paramètre WorkgroupName pour spécifier le nom du groupe de travail auquel les ordinateurs sont ajoutés.
Exemples
Exemple 1 : Supprimer l’ordinateur local de son domaine
Cet exemple supprime l’ordinateur local du domaine auquel il est joint.
Remove-Computer -UnjoinDomaincredential Domain01\Admin01 -PassThru -Verbose -Restart
Le paramètre UnjoinDomainCredential fournit les informations d’identification d’un administrateur de domaine. Les PassThru et les paramètres détaillé affichent des informations sur la réussite ou l’échec de la commande. Le paramètre Redémarrer redémarre l’ordinateur pour terminer l’opération de suppression.
Lorsqu’aucun nom de groupe de travail n’est spécifié, l’ordinateur est déplacé vers le groupe de travail nommé après sa suppression de son domaine.
Exemple 2 : Déplacer plusieurs ordinateurs vers un groupe de travail hérité
Cet exemple supprime tous les ordinateurs répertoriés dans le fichier OldServers.txt de leurs domaines et les déplace dans le groupe de travail hérité.
Remove-Computer -ComputerName (Get-Content OldServers.txt) -LocalCredential Domain01\Admin01 -UnJoinDomainCredential Domain01\Admin01 -WorkgroupName "Legacy" -Force -Restart
Le paramètre LocalCredential fournit les informations d’identification d’un utilisateur autorisé à se connecter à des ordinateurs distants. Le paramètre UnjoinDomainCredential fournit les informations d’identification d’un utilisateur autorisé à supprimer les ordinateurs de leurs domaines. Le paramètre Forcer supprime les invites de confirmation de chaque ordinateur. Le paramètre Redémarrer redémarre chacun des ordinateurs après sa suppression de son domaine.
Exemple 3 : Supprimer des ordinateurs d’un groupe de travail sans confirmation
Cet exemple montre comment supprimer l’ordinateur distant, Server01 et l’ordinateur local de leurs domaines et les ajouter au groupe de travail local.
Remove-Computer -ComputerName "Server01", "localhost" -UnjoinDomainCredential Domain01\Admin01 -WorkgroupName "Local" -Restart -Force
Le paramètre Forcer supprime l’invite de confirmation de chaque ordinateur. Le paramètre Redémarrer redémarre les ordinateurs pour que la modification soit effective.
Paramètres
-ComputerName
Spécifie les ordinateurs à supprimer de leurs domaines. La valeur par défaut est l’ordinateur local.
Tapez le nom NetBIOS, une adresse IP ou un nom de domaine complet (FQDN) des ordinateurs distants. Pour spécifier l’ordinateur local, tapez le nom de l’ordinateur, un point (.) ou localhost.
Ce paramètre ne repose pas sur la communication à distance de PowerShell. Vous pouvez utiliser le paramètre ComputerName de Remove-Computer même si votre ordinateur n’est pas configuré pour exécuter des commandes distantes.
Ce paramètre a été introduit dans 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
Remote
| 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 |
-Force
Supprime l’invite de l’utilisateur. Par défaut, Remove-Computer vous invite à confirmer avant de supprimer chaque ordinateur.
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 |
-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, l’applet de commande vous invite à 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.
Ce paramètre a été introduit dans 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
Remote
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-PassThru
Retourne les résultats de la commande. Sinon, 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
Indique que cette applet de commande redémarre les ordinateurs en cours de suppression. Un redémarrage est souvent nécessaire pour rendre la modification effective.
Ce paramètre a été introduit dans PowerShell 3.0.
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 |
-UnjoinDomainCredential
Spécifie un compte d’utilisateur autorisé à supprimer les ordinateurs de leurs domaines actuels. Les informations d’identification explicites, telles que fournies par ce paramètre, sont requises pour supprimer les ordinateurs distants d’un domaine, même lorsque la valeur est les informations d’identification de 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 Get-Credential. Si vous tapez un nom d’utilisateur, cette applet de commande vous invite à entrer un mot de passe.
Pour spécifier un compte d’utilisateur autorisé à se connecter aux ordinateurs distants, utilisez le paramètre LocalCredential.
Ce paramètre a été introduit dans 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 |
| Alias: | Informations d'identification |
Jeux de paramètres
Local
| Position: | 0 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
Remote
| Position: | 0 |
| Obligatoire: | True |
| 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 lorsqu’ils sont supprimés de leurs domaines. La valeur par défaut est WORKGROUP. Lorsque vous supprimez un ordinateur d’un domaine, vous devez l’ajouter à un groupe de travail.
Ce paramètre a été introduit dans 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é: | 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 vers cette applet de commande.
Sorties
ComputerChangeInfo
Lorsque vous utilisez le paramètre PassThru
Notes
Cette applet de commande ne supprime pas les ordinateurs des groupes de travail.
