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.