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 do Windows.

O Out-Printer cmdlet envia a saída para a impressora predefinida ou para uma impressora alternativa, se for especificado. Uma vez que o cmdlet não tem qualquer forma de configurar a tarefa de impressão, a tarefa de impressão resultante utiliza as predefinições definidas para a impressora.

Nota

Este cmdlet foi reintroduzido no PowerShell 7. Este cmdlet só está disponível em sistemas Windows que suportem o Windows Desktop.

Exemplos

Exemplo 1 - Enviar um ficheiro para ser impresso na impressora predefinida

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

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

Get-Contentobtém o conteúdo do readme.txt ficheiro no diretório atual e encaminha-o para Out-Printero , que o envia para a impressora predefinida.

Exemplo 2: Imprimir uma cadeia numa impressora remota

Este exemplo é impresso Hello, World na impressora Cor Prt-6B no Server01.

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

O parâmetro Nome seleciona uma impressora específica, em vez da predefinição.

Exemplo 3 - Imprimir um tópico de ajuda para a impressora predefinida

Este exemplo imprime a versão completa do tópico de 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 transmite o valor de $H para Out-Printer.

Parâmetros

-InputObject

Especifica os objetos a enviar para a impressora. Introduza uma variável que contenha os objetos ou escreva 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 Nome é opcional.

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

Entradas

PSObject

Pode encaminhar qualquer objeto para este cmdlet.

Saídas

None

Este cmdlet não devolve nenhuma saída.

Notas

Este cmdlet só está disponível nas plataformas do Windows.

Os cmdlets que contêm o Out verbo não formatam objetos. Apenas os compõem e enviam-nos para o destino de apresentação especificado. Se enviar um objeto não formatado para um Out cmdlet, o cmdlet envia-o para um cmdlet de formatação antes de o compor.

Out-Printer envia dados para a impressora, mas não emite objetos de saída para o pipeline. Se encaminhar a saída de Out-Printer para Get-Member, Get-Member comunica que não foram especificados objetos.