Share via

Remove-CMDevice

  • Référence
Module:
ConfigurationManager

Supprime un appareil client de Configuration Manager.

Syntax

Remove-CMDevice
      [-Force]
      [-InputObject] <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMDevice
      [-Force]
      [-Name] <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMDevice
      [-Force]
      [-ResourceId] <Int32>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

L’applet de commande Remove-CMDevice supprime un ou plusieurs appareils clients Configuration Manager. Ne supprimez pas un client si vous souhaitez désinstaller le client ou le supprimer d’un regroupement.

Remarque

Exécutez Configuration Manager applets de commande à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Supprimer un appareil par son nom

PS XYZ:\> Remove-CMDevice -DeviceName "WIN10-86-33"

Cette commande supprime l’appareil nommé WIN10-86-33.

Exemple 2 : Obtenir un appareil et le supprimer

PS XYZ:\> Get-CMDevice -Name "TestVLAN-VNEXT" | Remove-CMDevice

Cette commande obtient l’objet d’appareil nommé TestVLAN-VNEXT et utilise l’opérateur de pipeline pour passer l’objet à Remove-CMDevice, ce qui supprime l’objet device.

Paramètres

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

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

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

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

-Force

Force l’exécution de la commande sans demander la confirmation de l’utilisateur.

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

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

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

-InputObject

Spécifie un objet d’appareil. Pour obtenir un objet d’appareil, utilisez l’applet de commande Get-CMDevice .

Type:IResultObject
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Spécifie le nom d’un appareil.

Type:String
Aliases:DeviceName
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-ResourceId

Spécifie l’ID de ressource d’un appareil.

Type:Int32
Aliases:Id, DeviceId
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

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

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object