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

O Out-Printer cmdlet envia a saída para a impressora padrão ou para uma impressora alternativa, se uma for especificada. Como o cmdlet não tem nenhuma maneira de configurar o trabalho de impressão, o trabalho de impressão resultante usa as configurações padrão definidas para a impressora.

Observação

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

Exemplos

Exemplo 1 - Enviar um arquivo a ser impresso na impressora padrão

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

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

Get-ContentObtém o readme.txt conteúdo do arquivo no diretório atual e o canaliza 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 colorida Prt-6B no Server01.

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

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

Exemplo 3 - Imprimir um tópico de ajuda na impressora padrão

Este exemplo imprime a versão completa do tópico Get-CimInstanceda Ajuda do .

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

Get-Help obtém a versão completa do tópico da Ajuda e Get-CimInstance a armazena 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 canalizar qualquer objeto para esse cmdlet.

Saídas

None

Esse cmdlet não retorna nenhuma saída.

Observações

O Windows PowerShell inclui os seguintes aliases para Out-Printer:

  • lp

Os cmdlets que contêm o verbo Out não formatam 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ê canalizar a saída de Out-Printer para Get-Member, Get-Member informará que nenhum objeto foi especificado.