Get-PrintJob is a Windows PowerShell command that is used to retrieve information about print jobs that are currently active on a printer. It can be used to view the status of print jobs, the number of pages printed, the user who submitted the job, and more. This command is useful for troubleshooting printing issues, as it can provide detailed information about the jobs that are currently being processed.
Syntax
The syntax for the Get-PrintJob command is as follows:
Get-PrintJob [-Name] <String[]> [-ComputerName <String[]>] [-CimSession <CimSession[]>] [-ThrottleLimit <Int32>] [-AsJob] [-Authentication <AuthenticationLevel>] [-Credential <PSCredential>] [-Impersonation <ImpersonationLevel>] [-IncludeUserName] [-JobId <UInt32[]>] [-MaxCount <Int32>] [-NameMatchType <String>] [-Owner <String[]>] [-Status <PrintJobStatus[]>] [-UserName <String[]>] [-Confirm] [-WhatIf] [<CommonParameters>]
Parameters
The Get-PrintJob command has several parameters that can be used to customize the output of the command. These parameters are:
- Name – This parameter is used to specify the name of the print job.
- ComputerName – This parameter is used to specify the name of the computer that the print job is running on.
- CimSession – This parameter is used to specify the CimSession object that is used to connect to the computer.
- ThrottleLimit – This parameter is used to specify the maximum number of concurrent operations that can be performed.
- AsJob – This parameter is used to run the command as a background job.
- Authentication – This parameter is used to specify the authentication level that is used when connecting to the computer.
- Credential – This parameter is used to specify the credentials that are used when connecting to the computer.
- Impersonation – This parameter is used to specify the impersonation level that is used when connecting to the computer.
- IncludeUserName – This parameter is used to include the user name of the user who submitted the print job.
- JobId – This parameter is used to specify the ID of the print job.
- MaxCount – This parameter is used to specify the maximum number of print jobs that will be returned.
- NameMatchType – This parameter is used to specify the type of matching that will be used when searching for print jobs.
- Owner – This parameter is used to specify the user who submitted the print job.
- Status – This parameter is used to specify the status of the print job.
- UserName – This parameter is used to specify the user name of the user who submitted the print job.
- Confirm – This parameter is used to prompt the user for confirmation before running the command.
- WhatIf – This parameter is used to display what would happen if the command was run without actually running the command.
Inputs
The Get-PrintJob command does not accept any inputs.
Outputs
The Get-PrintJob command returns an object for each print job that is found. The object contains information about the print job, such as the name, status, user name, and more.
Examples
The following example retrieves information about all print jobs that are currently active on the local computer:
Get-PrintJob
The following example retrieves information about all print jobs that are currently active on the computer named “Server01”:
Get-PrintJob -ComputerName Server01
The following example retrieves information about all print jobs that are currently active on the computer named “Server01” and are owned by the user “User01”:
Get-PrintJob -ComputerName Server01 -Owner User01
Tips
The Get-PrintJob command can be used to troubleshoot printing issues. Here are some tips for using the command:
- Check the status of the print job. If the status is “Error”, then the job has failed.
- Check the user name of the user who submitted the job. If the user name is incorrect, then the job may not be printed.
- Check the number of pages that have been printed. If the number is lower than expected, then the job may not have been printed correctly.
- Check the name of the print job. If the name is incorrect, then the job may not be printed correctly.
- Check the computer name of the computer that the job is running on. If the computer name is incorrect, then the job may not be printed correctly.