Partilhar 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

Este 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 como configurar o trabalho de impressão, o trabalho de impressão resultante usa as configurações padrão definidas para a impressora.

Nota

Este cmdlet foi reintroduzido no PowerShell 7. Este cmdlet só está disponível em sistemas Windows que suportam a Á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, 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 canaliza-o para Out-Printero , que o envia para a impressora padrão.

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

Este exemplo é impresso 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 da Ajuda do Get-CimInstance.

$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 contenha os objetos ou digite um comando ou expressão que obtenha 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 este cmdlet.

Saídas

None

Este cmdlet não retorna nenhuma saída.

Notas

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