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 uma for especificada. Como o cmdlet não tem como configurar o trabalho de impressão, o trabalho de impressão resultante usa as configurações padrão definidas para a impressora.
Observação
Este cmdlet foi reintroduzido no PowerShell 7. Este cmdlet só está disponível em sistemas Windows que suportam a Á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, mesmo que 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 canaliza-o 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 de 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 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
Envia a saída para a impressora especificada. 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 este cmdlet.
Saídas
None
Este cmdlet não retorna nenhuma saída.
Notas
O Windows PowerShell inclui os seguintes aliases para Out-Printer:
lp
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.
Out-Printer envia dados para a impressora, mas não emite nenhum objeto de saída para o pipeline. Se você canalizar a saída de Out-Printer para Get-Member, Get-Member informará que nenhum objeto foi especificado.
