PowerShell/docs/list-print-jobs.md

91 lines
1.8 KiB
Markdown
Raw Normal View History

2024-01-25 13:37:12 +01:00
Script: *list-print-jobs.ps1*
========================
2021-11-08 21:36:42 +01:00
2022-02-10 09:01:07 +01:00
This PowerShell script lists all print jobs of all printer devices.
2021-11-08 21:36:42 +01:00
2023-07-29 10:04:38 +02:00
Parameters
----------
2021-11-08 21:36:42 +01:00
```powershell
2023-07-29 10:15:44 +02:00
PS> ./list-print-jobs.ps1 [<CommonParameters>]
2021-11-08 21:36:42 +01:00
[<CommonParameters>]
This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction,
WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
```
2023-07-29 10:04:38 +02:00
Example
-------
2021-11-08 21:36:42 +01:00
```powershell
2023-08-06 21:36:33 +02:00
PS> ./list-print-jobs.ps1
Printer Jobs
------- ----
ET-2810 Series none
...
2021-11-08 21:36:42 +01:00
```
2023-07-29 10:04:38 +02:00
Notes
-----
2022-11-17 19:46:02 +01:00
Author: Markus Fleschutz | License: CC0
2021-11-08 21:36:42 +01:00
2023-07-29 10:04:38 +02:00
Related Links
-------------
2021-11-08 21:36:42 +01:00
https://github.com/fleschutz/PowerShell
2023-07-29 10:04:38 +02:00
Script Content
--------------
2022-11-17 20:05:34 +01:00
```powershell
2022-11-17 20:02:26 +01:00
<#
.SYNOPSIS
2023-05-26 12:20:18 +02:00
Lists all print jobs
2022-11-17 20:02:26 +01:00
.DESCRIPTION
This PowerShell script lists all print jobs of all printer devices.
.EXAMPLE
2023-08-06 21:36:33 +02:00
PS> ./list-print-jobs.ps1
Printer Jobs
------- ----
ET-2810 Series none
...
2022-11-17 20:02:26 +01:00
.LINK
https://github.com/fleschutz/PowerShell
.NOTES
Author: Markus Fleschutz | License: CC0
#>
#Requires -Version 4
2023-05-26 12:20:18 +02:00
function ListPrintJobs {
2022-11-17 20:02:26 +01:00
$printers = Get-Printer
if ($printers.Count -eq 0) { throw "No printer found" }
foreach ($printer in $printers) {
2023-05-26 12:20:18 +02:00
$PrinterName = $printer.Name
2022-11-17 20:02:26 +01:00
$printjobs = Get-PrintJob -PrinterObject $printer
if ($printjobs.Count -eq 0) {
2023-05-26 12:20:18 +02:00
$PrintJobs = "none"
2022-11-17 20:02:26 +01:00
} else {
2023-05-26 12:20:18 +02:00
$PrintJobs = "$printjobs"
2022-11-17 20:02:26 +01:00
}
2023-05-26 12:20:18 +02:00
New-Object PSObject -Property @{ Printer=$PrinterName; Jobs=$PrintJobs }
}
}
try {
if ($IsLinux) {
# TODO
} else {
ListPrintJobs | Format-Table -property Printer,Jobs
2022-11-17 20:02:26 +01:00
}
exit 0 # success
} catch {
"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
exit 1
}
2022-11-17 20:05:34 +01:00
```
2022-11-17 20:02:26 +01:00
2024-03-27 17:36:59 +01:00
*(generated by convert-ps2md.ps1 using the comment-based help of list-print-jobs.ps1 as of 03/27/2024 17:36:28)*