Out-Printer
Envia a saída para uma impressora.
Syntax
Out-Printer
[[-Name] <String>]
[-InputObject <PSObject>]
[<CommonParameters>]
Description
Esse cmdlet só está disponível na plataforma Windows.
O Out-Printer
cmdlet envia a saída para a impressora padrão ou para uma impressora alternativa, se for especificado.
Observação
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-Content
obtém o conteúdo do readme.txt
arquivo 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
na impressora Prt-6B Color 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 para a impressora padrão
Este exemplo imprime a versão completa do tópico 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 ajuda para Get-CimInstance
e armazena-a na $H
variável . 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 contém os objetos ou digite um comando ou uma expressão que obtém os objetos.
Type: | PSObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Envia a saída para a impressora especificada. O nome do parâmetro Name é opcional.
Type: | String |
Aliases: | PrinterName |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Você pode redirecionar qualquer objeto para Out-Printer
.
Saídas
None
Out-Printer
não retorna nenhum objeto.
Observações
Esse cmdlet só está disponível em plataformas Windows.
Os cmdlets que contêm o Out
verbo não formatizam 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 Out
cmdlet, 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.