Out-Printer
Envia a saída para uma impressora.
Sintaxe
Default (Default)
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.
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
Este cmdlet está disponível apenas em plataformas Windows.
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.