Out-Printer
Envia a saída para uma impressora.
Sintaxe
Default (Predefinição)
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 especificada.
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 do about_Signing para a impressora padrão. Este 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 o envia para a impressora padrão.
Exemplo 2: Imprimir texto numa impressora alternativa
PS C:\> "Hello, World" | Out-Printer -Name "\\Server01\Prt-6B Color"
Este comando imprime Olá, Mundo para a impressora Prt-6B Color no 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: Imprimir a versão completa de um tópico de ajuda na 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 obtenha os objetos.
Propriedades dos parâmetros
| Tipo: | PSObject |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Name
Especifica a impressora alternativa. O nome do parâmetro Nome é opcional.
Propriedades dos parâmetros
| Tipo: | String |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | PrinterName |
Conjuntos de parâmetros
(All)
| Position: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
PSObject
Você pode canalizar qualquer objeto para Out-Printer .
Saídas
None
Out-Printer não retorna nenhum objeto.
Notas
Você também pode se referir a 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 formatam objetos; eles apenas os renderizam e 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 informará que nenhum objeto foi especificado.