Compartilhar via

Out-Printer

  • Referência
Módulo:
Microsoft.PowerShell.Utility

Envia a saída para uma impressora.

Sintaxe

Out-Printer
   [[-Name] <String>]
   [-InputObject <PSObject>]
   [<CommonParameters>]

Description

O cmdlet Out-Printer envia a saída para a impressora padrão ou para uma impressora alternativa, se for especificado.

Exemplos

Exemplo 1: imprimir o conteúdo de um tópico de ajuda na impressora padrão

PS C:\> Get-Content $pshome\about_signing.help.txt | Out-Printer

Este comando imprime o conteúdo do tópico da Ajuda about_Signing para a impressora padrão. Este exemplo mostra como imprimir um arquivo, embora de Impressora Out não tenha um parâmetro Path.

O comando usa o cmdlet Get-Content para obter o conteúdo do tópico da Ajuda. O caminho inclui $pshome, uma variável interna que armazena o diretório de instalação do Windows PowerShell. Um operador de pipeline (|) passa os resultados para out-Printer, que o envia para a impressora padrão.

Exemplo 2: Imprimir texto em uma impressora alternativa

PS C:\> "Hello, World" | Out-Printer -Name "\\Server01\Prt-6B Color"

Este comando imprime Hello, World para a impressora Prt-6B Color no Server01. Esse comando usa o parâmetro Name para especificar a impressora alternativa. Como o nome do parâmetro é opcional, você pode omitê-lo.

Exemplo 3: imprimir a versão completa de um tópico de ajuda para a impressora padrão

PS C:\> $H = Get-Help -Full Get-WmiObject
PS C:\> Out-Printer -InputObject $H

Esses comandos imprimem a versão completa do tópico da Ajuda para Get-WmiObject. O primeiro comando usa o cmdlet Get-Help para obter a versão completa do tópico da Ajuda para Get-WmiObject e o armazena na variável $H. O segundo comando envia o conteúdo para a impressora padrão. Ele usa o parâmetro InputObject para passar o valor da variável $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 obtém os objetos.

Tipo:PSObject
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

Especifica a impressora alternativa. O nome do parâmetro Name é opcional.

Tipo:String
Aliases:PrinterName
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

PSObject

Você pode canalizar qualquer objeto para out-printer .

Saídas

None

out-printer não retorna nenhum objeto.

Observações

  • Você também pode consultar out-printer por seu alias interno, lp. Para obter mais informações, consulte about_Aliases.

    Os cmdlets que contêm o verbo Out não formatizam objetos; eles simplesmente os renderizam e os enviam para o destino de exibição especificado. Se você enviar um objeto não formatado para um cmdlet Out, o cmdlet o enviará para um cmdlet de formatação antes de renderizá-lo.

    Os cmdlets Out não têm parâmetros para nomes ou caminhos de arquivo. Para enviar dados para um cmdlet Out, use um operador de pipeline (|) para enviar a saída de um comando do Windows PowerShell para o cmdlet. Você também pode armazenar dados em uma variável e usar o parâmetro InputObject para passar os dados para o cmdlet. Para obter mais informações, consulte os exemplos.

    out-printer envia dados, mas não emite nenhum objeto de saída. Se você canalizar a saída de out-printer para Get-Member, Get-Member relatará que nenhum objeto foi especificado.