Passer au contenu principal

Remove-PrintJob

Supprime un travail d'impression sur l'imprimante spécifiée.

Syntaxe

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

Remove-PrintJob
      [-ComputerName <String>]
      [-ID] <UInt32>
      [-PrinterName] <String>
      [-CimSession <CimSession[]>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-PrintJob
      [-ID] <UInt32>
      [-PrinterObject] <CimInstance>
      [-CimSession <CimSession[]>]
      [-ThrottleLimit <Int32>]
      [-AsJob]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

La cmdlet Remove-PrintJob supprime une tâche d'impression sur l'imprimante spécifiée.

Vous pouvez spécifier la tâche d'impression à supprimer en spécifiant les paramètres PrinterName et ID, en spécifiant l'objet et la tâche de l'imprimante et le paramètre ID, ou en spécifiant un objet de tâche d'impression en entrée.

Vous ne pouvez pas utiliser de caractères génériques avec Remove-PrintJob. Vous pouvez utiliser Remove-PrintJob dans une session à distance Windows PowerShell.

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

Exemples

Exemple 1: Supprimer une tâche d'impression sélectionnée

Remove-PrintJob -PrinterName "PrinterName" -ID 1

Cette commande supprime la tâche d'impression qui a un ID de 1 sur l'imprimante nommée PrinterName.

Exemple 2: Supprimer une tâche d'impression à l'aide de l'objet imprimante et de l'ID de tâche d'impression

$Printer = Get-Printer -PrinterName "PrinterName"
Remove-PrintJob -PrinterObject $Printer -ID "1"

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

La deuxième commande supprime la tâche d'impression qui a un ID de 1 de l'imprimante dans $Printer.

Exemple 3: Supprimer une tâche d'impression à l'aide d'un objet tâche d'impression

$printJob = Get-PrintJob - PrinterName "PrinterName" -ID 1
Remove-PrintJob -InputObject $printJob

La première commande obtient une tâche d'impression qui a un ID de 1 sur l'imprimante nommée PrinterName à l'aide de l'applet de commande Get-PrintJob. La commande stocke la tâche dans la variable $PrintJob.

La deuxième tâche supprime la tâche d'impression dans $PrintJob.

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 sur lequel supprimer la tâche d'impression.

 

-Confirm

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

 

-ID

Spécifie l'ID d'une tâche d'impression à supprimer sur l'imprimante spécifiée.

 

-InputObject

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

 

-PrinterName

Spécifie un nom d'imprimante sur lequel supprimer la tâche d'impression.

 

-PrinterObject

Spécifie l'objet qui contient l'imprimante sur laquelle supprimer la tâche d'impression.

 

-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.