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