Share via

Out-Printer

  • Referência
Módulo:
Microsoft.PowerShell.Utility

Envia a saída para uma impressora.

Syntax

Out-Printer
   [[-Name] <String>]
   [-InputObject <PSObject>]
   [<CommonParameters>]

Description

Esse cmdlet só está disponível na plataforma Windows.

O Out-Printer cmdlet envia a saída para a impressora padrão ou para uma impressora alternativa, se for especificado.

Observação

Este cmdlet foi reintroduzido no PowerShell 7. Esse cmdlet só está disponível em sistemas Windows que dão suporte à Área de Trabalho do Windows.

Exemplos

Exemplo 1 – Enviar um arquivo para ser impresso na impressora padrão

Este exemplo mostra como imprimir um arquivo, embora Out-Printer não tenha um parâmetro Path .

Get-Content -Path ./readme.txt | Out-Printer

Get-Contentobtém o conteúdo do readme.txt arquivo no diretório atual e o redireciona para Out-Printer, que o envia para a impressora padrão.

Exemplo 2: Imprimir uma cadeia de caracteres em uma impressora remota

Este exemplo imprime Hello, World na impressora Prt-6B Color no Server01.

"Hello, World" | Out-Printer -Name "\\Server01\Prt-6B Color"

O parâmetro Name seleciona uma impressora específica, em vez do padrão.

Exemplo 3 – Imprimir um tópico de ajuda para a impressora padrão

Este exemplo imprime a versão completa do tópico ajuda para Get-CimInstance.

$H = Get-Help -Full Get-CimInstance
Out-Printer -InputObject $H

Get-Help obtém a versão completa do tópico ajuda para Get-CimInstance e armazena-a na $H variável . O parâmetro InputObject passa o valor de $H para Out-Printer.

Parâmetros

-InputObject

Especifica os objetos a serem enviados para a impressora. Insira uma variável que contém os objetos ou digite um comando ou uma expressão que obtém os objetos.

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Envia a saída para a impressora especificada. O nome do parâmetro Name é opcional.

Type:String
Aliases:PrinterName
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

PSObject

Você pode redirecionar qualquer objeto para Out-Printer.

Saídas

None

Out-Printer não retorna nenhum objeto.

Observações

Esse cmdlet só está disponível em plataformas Windows.

Os cmdlets que contêm o Out verbo não formatizam objetos. Eles apenas os renderizam e os enviam para o destino de exibição especificado. Se você enviar um objeto não formatado para um Out cmdlet, o cmdlet o enviará para um cmdlet de formatação antes de renderizá-lo.

Out-Printer envia dados para a impressora, mas não emite nenhum objeto de saída para o pipeline. Se você redirecionar a saída de Out-Printer para Get-Member, Get-Member relatará que nenhum objeto foi especificado.