Get-Printer

Get-Printer

Retrieves a list of printers installed on a computer.

構文

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

詳細説明

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.

パラメーター

-AsJob

-CimSession<CimSession[]>

リモート セッションまたはリモート コンピューターでコマンドレットを実行します。New-CimSession コマンドレットや Get-CimSession コマンドレットの出力など、コンピューター名またはセッション オブジェクトを入力します。既定値は、ローカル コンピューターで実行中の現在のセッションです。

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

このコマンドレットを実行するために確立できる最大同時操作数を指定します。このパラメーターを省略するか、値として 0 を入力した場合、Windows PowerShell® では、コンピューターで実行している CIM コマンドレットの数に基づいて、コマンドレットに対する最適なスロットル制限を計算します。スロットル制限は現在のコマンドレットのみに適用され、セッションまたはコンピューターには適用されません。

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

• None

  This cmdlet accepts no input objects.

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

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

  This cmdlet outputs one or more printer objects.

例

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"

関連トピック

Add-Printer

Set-Printer

Remove-Printer

Rename-Printer