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

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

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.