Get-Printer

Get-Printer

Retrieves a list of printers installed on a computer.

Syntax

Parameter Set: Query (cdxml)
Get-Printer [[-Name] <String[]> ] [-AsJob] [-CimSession <CimSession[]> ] [-ComputerName <String> ] [-Full] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Detaillierte Beschreibung

The Get-Printer cmdlet retrieves a list of printers installed on a computer. You can also use Get-Printer to retrieve the properties of a single printer, and then use that information as input into other cmdlets.

You can use wildcard characters with Get-Printer. You can use a Get-Printer in a Windows PowerShell remoting session.

You do not need administrator privileges to use Get-Printer.

Parameter

-AsJob

-CimSession<CimSession[]>

Führt das Cmdlet in einer Remotesitzung oder auf einem Remotecomputer aus. Geben Sie einen Computernamen oder ein Sitzungsobjekt ein, z. B. die Ausgabe eines Cmdlets New-CimSession oder Get-CimSession. Der Standardwert ist die aktuelle Sitzung auf dem lokalen Computer.

-ComputerName<String>

Specifies the name of the computer from which to retrieve the printer information.

-Full

Specifies all the printer parameters to retrieve including RenderingMode and PermissionSDDL.

-Name<String[]>

Specifies the name of the printer about which to retrieve information.

-ThrottleLimit<Int32>

Gibt die maximale Anzahl von gleichzeitigen Vorgängen an, die zum Ausführen dieses Cmdlets eingerichtet werden können. Wenn dieser Parameter ausgelassen oder der Wert 0 eingegeben wird, berechnet Windows PowerShell® einen optimalen Drosselungsgrenzwert für das Cmdlet basierend auf der Anzahl der CIM-Cmdlets, die auf dem Computer ausgeführt werden. Die Drosselungsgrenze gilt nur für das aktuelle Cmdlet und nicht für die Sitzung oder den Computer.

<CommonParameters>

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Eingaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können.

• None

  This cmdlet accepts no input objects.

Ausgaben

Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.

• Microsoft.Management.Infrastructure.CimInstance#ROOT/StandardCimv2/MSFT_Printer

  This cmdlet outputs one or more printer objects.

Beispiele

Example 1: Get a list of printers

This command retrieves a list of printers and printer connections on the local computer.

PS C:\> Get-Printer

Example 2: Get the information for a specific printer

This command retrieves information for one specific printer named "Microsoft XPS Document Writer".

PS C:\> Get-Printer –Name "Microsoft XPS Document Writer"

Example 3: Get the detailed information for a specific printer

This command retrieves detailed information for one specific printer named "Microsoft XPS Document Writer".

PS C:\> Get-Printer –Name "Microsoft XPS Document Writer" | Format-List

Example 4: Get a list of printers on a remote computer

This command retrieves a list of printers from the computer named PrintServer.

PS C:\> Get-Printer -ComputerName PrintServer

Example 5: Get a list of printer objects and then rename the printers

This set of commands retrieves a printer object into a variable ($Printer) and then passes the contents of the variable to Rename-Printer.

PS C:\> $Printer = Get-Printer -Name “Microsoft XPS Document Writer"

PS C:\> Rename-Printer -InputObject $printer "MXDW"

Verwandte Themen

Add-Printer

Set-Printer

Remove-Printer

Rename-Printer