Compartir a través de

Out-Printer

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Envía los resultados a una impresora.

Syntax

Out-Printer
   [[-Name] <String>]
   [-InputObject <PSObject>]
   [<CommonParameters>]

Description

Este cmdlet solo está disponible en la plataforma Windows.

El Out-Printer cmdlet envía la salida a la impresora predeterminada o a una impresora alternativa, si se especifica una. Dado que el cmdlet no tiene ninguna manera de configurar el trabajo de impresión, el trabajo de impresión resultante usa la configuración predeterminada definida para la impresora.

Nota:

Este cmdlet se ha vuelto a introducir en PowerShell 7. Este cmdlet solo está disponible en sistemas Windows que admiten el escritorio de Windows.

Ejemplos

Ejemplo 1: Envío de un archivo que se imprimirá en la impresora predeterminada

En este ejemplo se muestra cómo imprimir un archivo, aunque Out-Printer no tenga un parámetro Path .

Get-Content -Path ./readme.txt | Out-Printer

Get-Contentobtiene el contenido del readme.txt archivo en el directorio actual y lo canaliza a Out-Printer, que lo envía a la impresora predeterminada.

Ejemplo 2: Imprimir una cadena en una impresora remota

En este ejemplo se imprime Hello, World en la impresora Prt-6B Color en Server01.

"Hello, World" | Out-Printer -Name "\\Server01\Prt-6B Color"

El parámetro Name selecciona una impresora específica, en lugar del valor predeterminado.

Ejemplo 3: Imprimir un tema de ayuda en la impresora predeterminada

En este ejemplo se imprime la versión completa del tema de Ayuda para Get-CimInstance.

$H = Get-Help -Full Get-CimInstance
Out-Printer -InputObject $H

Get-Help obtiene la versión completa del tema de Ayuda para Get-CimInstance y la almacena en la $H variable . El parámetro InputObject pasa el valor de $H a Out-Printer.

Parámetros

-InputObject

Especifica los objetos que se van a enviar a la impresora. Especifique una variable que contenga los objetos o escriba un comando o una expresión que obtenga los objetos.

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Envía la salida a la impresora especificada. El nombre del parámetro Name es opcional.

Type:String
Aliases:PrinterName
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

PSObject

Puede canalizar cualquier objeto a este cmdlet.

Salidas

None

Este cmdlet no devuelve ningún resultado.

Notas

Este cmdlet solo está disponible en plataformas Windows.

Los cmdlets que contienen el Out verbo no dan formato a los objetos. Simplemente los representan y los envían al destino de presentación especificado. Si envía un objeto sin formato a un Out cmdlet, el cmdlet lo envía a un cmdlet de formato antes de representarlo.

Out-Printer envía datos a la impresora, pero no emite ningún objeto de salida a la canalización. Si canaliza la salida de Out-Printer a Get-Member, Get-Member notifica que no se ha especificado ningún objeto.