Partager via

Remove-Computer

  • Référence
Module:
Microsoft.PowerShell.Management

Supprime l’ordinateur local de son domaine.

Syntax

Remove-Computer
      [[-UnjoinDomainCredential] <PSCredential>]
      [-Restart]
      [-Force]
      [-PassThru]
      [-WorkgroupName <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-Computer
      -UnjoinDomainCredential <PSCredential>
      [-LocalCredential <PSCredential>]
      [-Restart]
      [-ComputerName <String[]>]
      [-Force]
      [-PassThru]
      [-WorkgroupName <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

L’applet Remove-Computer de commande 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’il s’agit des informations d’identification de l’utilisateur actuel. Vous devez redémarrer l’ordinateur pour que la modification soit effective. De plus, 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 vers un autre, ou d’un domaine vers 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 utilisateur, utilisez le paramètre Force.

Remove-Computer supprime l’ordinateur local et les ordinateurs distants des domaines. Elle inclut de nouveaux paramètres d'informations d'identification qui spécifient d'autres informations d'identification pour la connexion à des ordinateurs distants et la disjonction d'un domaine, un nouveau paramètre Restart pour le redémarrage des ordinateurs concernés et un paramètre WorkgroupName pour la spécification du 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 paramètres communs PassThru et Verbose affichent des informations sur la réussite ou l’échec de la commande. Le paramètre Restart 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 avoir été supprimé 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 OldServers.txt fichier 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 ses domaines. Le paramètre Force supprime les invites de confirmation pour chaque ordinateur. Le paramètre Restart redémarre chacun des ordinateurs une fois qu’il a été supprimé de son domaine.

Exemple 3 : Supprimer des ordinateurs d’un groupe de travail sans confirmation

Cet exemple supprime l’ordinateur distant Server01 et l’ordinateur local de leurs domaines et les ajoute au groupe de travail Local .

Remove-Computer -ComputerName "Server01", "localhost" -UnjoinDomainCredential Domain01\Admin01 -WorkgroupName "Local" -Restart -Force

Le paramètre Force supprime l’invite de confirmation pour chaque ordinateur. Le paramètre Restart 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 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 à distance.

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Supprime l’invite utilisateur. Par défaut, Remove-Computer vous invite à confirmer avant de supprimer chaque ordinateur.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LocalCredential

Spécifie un compte d’utilisateur qui est 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 Get-Credential commande. 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 qui a l’autorisation de supprimer l’ordinateur de son domaine actuel, utilisez le paramètre UnjoinDomainCredential.

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

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Retourne les résultats de la commande. Sinon, cette applet de commande ne génère aucune sortie.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Restart

Indique que cette applet de commande redémarre les ordinateurs en cours de suppression. Un redémarrage est souvent nécessaire pour que le changement devienne effectif.

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UnjoinDomainCredential

Spécifie un compte d’utilisateur qui a l’autorisation de supprimer les ordinateurs de leurs domaines actuels. Des informations d’identification explicites, fournies par ce paramètre, sont requises pour supprimer les ordinateurs distants d’un domaine, même lorsque la valeur est représentée par les informations d’identification de l’utilisateur actuel.

Tapez un nom d’utilisateur, par exemple User01 ou Domain01\User01, ou entrez un objet PSCredential , tel que celui 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 qui a l’autorisation de se connecter aux ordinateurs distants, utilisez le paramètre LocalCredential.

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

Type:PSCredential
Aliases:Credential
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

String

Vous pouvez diriger les noms d’ordinateurs vers thiscmdlet.

Sorties

ComputerChangeInfo

Lorsque vous utilisez le paramètre PassThru , Remove-Computer retourne un objet ComputerChangeInfo . Sinon, cette applet de commande ne génère aucune sortie.

Notes

Cette applet de commande ne supprime pas les ordinateurs des groupes de travail.