Out-Printer
Envía la salida a una impresora.
Out-Printer [[-Name] <string>] [-InputObject <psobject>] [<CommonParameters>]
El cmdlet Out-Printer envía la salida a la impresora predeterminada o a una impresora alternativa si se ha especificado alguna.
Especifica los objetos que se van a enviar a la impresora. Especifique la variable que contiene los objetos, o bien, escriba un comando o una expresión que obtenga los objetos.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
true (ByValue) |
¿Aceptar caracteres comodín? |
false |
Especifica la impresora alternativa. El nombre del parámetro ("Name") es opcional.
¿Requerido? |
false |
¿Posición? |
1 |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.
Entradas |
System.Management.Automation.PSObject Puede canalizar cualquier objeto a Out-Printer. |
Salidas |
Ninguno Out-Printer no devuelve ningún objeto. |
También puede hacer referencia a Out-Printer mediante su alias integrado, "lp". Para obtener más información, vea about_Aliases.
Los cmdlets que contienen el verbo Out (cmdlets Out) no dan formato a los objetos; solo los presentan y los envían al destino especificado. Si envía un objeto sin formato a un cmdlet Out, el cmdlet lo enviará a un cmdlet de formato antes de presentarlo.
Los cmdlets Out no tienen parámetros para los nombres o las rutas de archivos. Si desea enviar datos a un cmdlet Out, use el operador de canalización (|) para enviar el resultado de un comando de Windows PowerShell al cmdlet. También puede almacenar los datos en una variable y usar el parámetro InputObject para pasar los datos al cmdlet. Para obtener más información, vea los ejemplos.
Out-Printer envía los datos, pero no emite objetos de salida. Si canaliza el resultado de Out-Printer a Get-Member, Get-Member notificará que no se ha especificado ningún objeto.
C:\PS>get-content $pshome\about_signing.help.txt | Out-Printer
Descripción
-----------
Este comando imprime el contenido del tema de Ayuda about_Signing en la impresora predeterminada. En este ejemplo, se muestra cómo imprimir un archivo aunque no se haya especificado un parámetro Path en Out-Printer.
El comando utiliza el cmdlet Get-Content para obtener el contenido del tema de Ayuda. La ruta incluye $pshome, una variable integrada que almacena el directorio de instalación de Windows PowerShell. Un operador de canalización (|) pasa el resultado a Out-Printer, que lo envía a la impresora predeterminada.
C:\PS>"Hello, World" | out-printer -name "\\Server01\Prt-6B Color"
Descripción
-----------
Este comando imprime "Hello, World" en la impresora "Prt-6B Color" del equipo Server01. Este comando utiliza el parámetro Name para especificar la impresora alternativa. Dado que el nombre del parámetro es opcional, puede omitirse.
C:\PS>$h = get-help -full get-wmiobject
C:\PS> out-printer -inputobject $h
Descripción
-----------
Estos comandos imprimen la versión completa del tema de Ayuda de Get-WmiObject. El primer comando usa el cmdlet Get-Help para obtener la versión completa del tema de Ayuda de Get-WmiObject y la almacena en la variable $h. El segundo comando envía el contenido a la impresora predeterminada. Usa el parámetro InputObject para pasar el valor de la variable $h a Out-Printer.