PowerShell/Docs/list-print-jobs.md

73 lines
1.5 KiB
Markdown
Raw Normal View History

2023-07-29 09:55:25 +02: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
## Parameters
```powershell
2023-07-29 09:45:37 +02:00
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.
```
## Example
```powershell
PS> ./list-print-jobs
```
## Notes
2022-11-17 19:46:02 +01:00
Author: Markus Fleschutz | License: CC0
2021-11-08 21:36:42 +01:00
## Related Links
https://github.com/fleschutz/PowerShell
2023-07-29 09:55:25 +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
PS> ./list-print-jobs
.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
2023-07-29 09:55:25 +02:00
*(generated by convert-ps2md.ps1 using the comment-based help of list-print-jobs.ps1 as of 07/29/2023 09:55:12)*