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.