Compartir a través de

Out-Printer

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Envía la salida a una impresora.

Sintaxis

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

Description

Este cmdlet solo está disponible en la plataforma Windows.

El cmdlet Out-Printer 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 archivo readme.txt 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 de color prt-6B de 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 variable $H. 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. Escriba una variable que contenga los objetos, o escriba un comando o expresión que obtenga los objetos.

Tipo:PSObject
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Name

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

Tipo:String
Alias:PrinterName
Posición:0
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

PSObject

Puede canalizar cualquier objeto a este cmdlet.

Salidas

None

Este cmdlet no devuelve ninguna salida.

Notas

Este cmdlet solo está disponible en plataformas Windows.

Los cmdlets que contienen el verbo Out 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 cmdlet de Out, 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 informa de que no se han especificado objetos.