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.
Vea también