Passer au contenu principal

Remove-Printer

Supprime une imprimante de l'ordinateur spécifié.

Syntaxe

Remove-Printer
      [-Name] <String[]>
      [-ComputerName <String>]
      [-CimSession <CimSession[]>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-Printer
      -InputObject <CimInstance[]>
      [-CimSession <CimSession[]>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

La cmdlet Remove-Printer supprime une imprimante de l'ordinateur spécifié. Vous pouvez spécifier l'imprimante à supprimer en utilisant soit un objet d'imprimante récupéré par Get-Printer, soit en spécifiant un nom d'imprimante.

Vous pouvez utiliser des caractères génériques avec Remove-Printer. Vous pouvez utiliser Remove-Printer dans une session à distance Windows PowerShell.

Vous n'avez pas besoin d'informations d'identification d'administrateur pour exécuter Remove-Printer.

Exemples

Exemple 1: Supprimer une imprimante spécifique

Remove-Printer -Name "Microsoft XPS Document Writer"

Cette commande supprime l'imprimante nommée Microsoft XPS Document Writer de l'ordinateur local.

Exemple 2: Supprimer une imprimante spécifique à l'aide d'un objet d'imprimante

$Printer = Get-Printer -Name "Microsoft XPS Document Writer"
Remove-Printer -InputObject $Printer

La première commande obtient l'imprimante nommée Microsoft XPS Document Writer à l'aide de l'applet de commande Get-Printer. La commande stocke le résultat dans la variable $Printer.

La deuxième commande supprime l'imprimante dans $Printer.

Paramètres

-AsJob

Exécute l'applet de commande en tant que tâche d'arrière-plan. Utilisez ce paramètre pour exécuter des commandes qui prennent beaucoup de temps.

-CimSession

Exécute l'applet de commande dans une session distante ou sur un ordinateur distant. Entrez un nom d'ordinateur ou un objet de session, tel que la sortie d'un applet New-CimSession ou Get-CimSession. La valeur par défaut est la session en cours sur l'ordinateur local.

 

-ComputerName

Spécifie le nom de l'ordinateur à partir duquel retirer l'imprimante.

 

-Confirm

Vous invite à confirmer avant d'exécuter l'applet de commande.

 

-InputObject

Spécifie l'objet d'entrée utilisé dans une commande de pipeline.

 

-Name

Spécifie le nom de l'imprimante à supprimer.

 

-PassThru

Renvoie un objet représentant l'élément avec lequel vous travaillez. Par défaut, cette applet de commande ne génère aucune sortie.

 

-ThrottleLimit

Spécifie le nombre maximal d'opérations simultanées qui peuvent être établies pour exécuter l'applet de commande. Si ce paramètre est omis ou si une valeur de 0 est entré, Windows PowerShell® calcule une limite d'accélération optimale pour l'applet de commande en fonction du nombre d'applets de commande CIM en cours d'exécution sur l'ordinateur. La limite d'accélération s'applique uniquement à l'applet de commande actuelle, et non à la session ou à l'ordinateur.

 

-WhatIf

Montre ce qui se passerait si l'applet de commande s'exécute. L'applet de commande n'est pas exécutée.