Compartilhar via


Out-Printer

Envia a saída para uma impressora.

Sintaxe

Out-Printer [[-Name] <string>] [-InputObject <psobject>] [<CommonParameters>]

Descrição

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

Parâmetros

-InputObject <psobject>

Especifica os objetos a serem enviados à impressora. Insira uma variável que contenha os objetos, ou digite um comando ou uma expressão que obtenha os objetos.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

true (ByValue)

Aceitar caracteres curinga?

false

-Name <string>

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

Necessário?

false

Posição?

1

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas

System.Management.Automation.PSObject

Você pode canalizar qualquer objeto para Out-Printer.

Saídas

Nenhum

Out-Printer não retorna objetos.

Observações

Você também pode fazer referência a Out-Printer usando seu alias interno, "lp". Para obter mais informações, consulte about_Aliases.

Os cmdlets que contêm o verbo Out (os cmdlets Out) não formatam objetos; eles apenas os processam e os enviam ao destino de exibição especificado. Se você enviar um objeto não formatado a um cmdlet Out, o cmdlet o envia a um cmdlet de formatação antes de renderizá-lo.

Os cmdlets Out não possuem parâmetros para nomes ou caminhos de arquivo. Para enviar dados a 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 ao cmdlet. Para obter mais informações, consulte os exemplos.

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

Exemplo 1

C:\PS>get-content $pshome\about_signing.help.txt | Out-Printer

Descrição
-----------
Esse comando imprime o conteúdo do tópico da Ajuda about_Signing na impressora padrão. Esse exemplo mostra como imprimir um arquivo, mesmo que Out-Printer 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 os envia para a impressora padrão.





Exemplo 2

C:\PS>"Hello, World" | out-printer -name "\\Server01\Prt-6B Color"

Descrição
-----------
Este comando imprime "Hello, World" na impressora "Prt-6B Color" em Server01. Este comando usa o parâmetro Name para especificar a impressora alternativa. Como o nome do parâmetro é opcional, você pode omiti-lo.





Exemplo 3

C:\PS>$h = get-help -full get-wmiobject

C:\PS> out-printer -inputobject $h

Descrição
-----------
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.





Consulte também

Conceitos

Out-Host
Out-Null
Out-String
Out-File
Out-Default