Out-Printer
Envia a saída para uma impressora.
Sintaxe
Out-Printer
[[-Name] <String>]
[-InputObject <PSObject>]
[<CommonParameters>]Description
Este cmdlet só está disponível na plataforma Windows.
O cmdlet Out-Printer envia a saída para a impressora padrão ou para uma impressora alternativa, se for especificado. Como o cmdlet não tem nenhuma maneira de configurar o trabalho de impressão, o trabalho de impressão resultante usa as configurações padrão definidas para a impressora.
Nota
Este cmdlet foi reintroduzido no PowerShell 7. Esse cmdlet só está disponível em sistemas Windows que dão suporte à Área de Trabalho do Windows.
Exemplos
Exemplo 1 – Enviar um arquivo para ser impresso na impressora padrão
Este exemplo mostra como imprimir um arquivo, embora Out-Printer não tenha um parâmetro Path.
Get-Content -Path ./readme.txt | Out-Printer
Get-Contentobtém o conteúdo do arquivo readme.txt no diretório atual e o redireciona para Out-Printer, que o envia para a impressora padrão.
Exemplo 2: imprimir uma cadeia de caracteres em uma impressora remota
Este exemplo imprime Hello, World para a impressora De Cor Prt-6B no Server01.
"Hello, World" | Out-Printer -Name "\\Server01\Prt-6B Color"O parâmetro Name seleciona uma impressora específica, em vez do padrão.
Exemplo 3 – Imprimir um tópico de ajuda na impressora padrão
Este exemplo imprime a versão completa do tópico da 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 da Ajuda para Get-CimInstance e a armazena na variável $H. O parâmetro InputObject passa o valor de $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
Envia a saída para a impressora especificada. 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
Você pode redirecionar qualquer objeto para este cmdlet.
Saídas
None
Esse cmdlet não retorna nenhuma saída.
Observações
Esse cmdlet só está disponível em plataformas Windows.
Os cmdlets que contêm o verbo Out não formatar objetos. Eles apenas 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.
Out-Printer envia dados para a impressora, mas não emite nenhum objeto de saída para o pipeline. Se você redirecionar a saída de Out-Printer para Get-Member, Get-Member relatará que nenhum objeto foi especificado.
