Out-Printer
Envia a saída para uma impressora.
Sintaxe
Default (Default)
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 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.
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-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 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 na 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 obtém os objetos.
Propriedades do parâmetro
| Tipo: | PSObject |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Name
Envia a saída para a impressora especificada. O nome do parâmetro Name é opcional.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | PrinterName |
Conjuntos de parâmetros
(All)
| Cargo: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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 redirecionar qualquer objeto para este cmdlet.
Saídas
None
Esse cmdlet não retorna nenhuma saída.
Observações
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 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.
