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

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