Out-Printer
Envía la salida a una impresora.
Sintaxis
Out-Printer [[-Name] <string>] [-InputObject <psobject>] [<CommonParameters>]
Descripción
El cmdlet Out-Printer envía la salida a la impresora predeterminada o a una impresora alternativa si se ha especificado alguna.
Parámetros
-InputObject <psobject>
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 |
-Name <string>
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 |
<CommonParameters>
Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.
Entradas y salidas
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. |
Notas
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.
Ejemplo 1
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.
Ejemplo 2
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.
Ejemplo 3
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.