Out-Printer
Envía la salida a una impresora.
Sintaxis
Default (valor predeterminado)
Out-Printer
[[-Name] <String>]
[-InputObject <PSObject>]
[<CommonParameters>]
Description
El cmdlet Out-Printer envía la salida a la impresora predeterminada o a una impresora alternativa, si se especifica una.
Ejemplos
Ejemplo 1: Imprimir el contenido de un tema de ayuda en la impresora predeterminada
PS C:\> Get-Content $pshome\about_signing.help.txt | Out-Printer
Este comando imprime el contenido del tema de ayuda de about_Signing en la impresora predeterminada. En este ejemplo se muestra cómo imprimir un archivo, aunque Out-Printer no tenga un parámetro Path.
El comando usa el cmdlet Get-Content para obtener el contenido del tema de Ayuda. La ruta de acceso incluye $pshome, una variable integrada que almacena el directorio de instalación para Windows PowerShell. Un operador de canalización (|) pasa los resultados a out-Printer, que lo envía a la impresora predeterminada.
Ejemplo 2: Imprimir texto en una impresora alternativa
PS C:\> "Hello, World" | Out-Printer -Name "\\Server01\Prt-6B Color"
Este comando imprime Hello, World en la impresora Prt-6B Color en Server01. Este comando usa el parámetro Name para especificar la impresora alternativa. Dado que el nombre del parámetro es opcional, puede omitirlo.
Ejemplo 3: Imprimir la versión completa de un tema de ayuda en la impresora predeterminada
PS C:\> $H = Get-Help -Full Get-WmiObject
PS C:\> Out-Printer -InputObject $H
Estos comandos imprimen la versión completa del tema de Ayuda para Get-WmiObject. El primer comando usa el cmdlet Get-Help para obtener la versión completa del tema de Ayuda para Get-WmiObject y almacenarlo 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.
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.
Propiedades de parámetro
| Tipo: | PSObject |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Name
Especifica la impresora alternativa. El nombre del parámetro Nombre es opcional.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | PrinterName |
Conjuntos de parámetros
(All)
| Posición: | 0 |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
Entradas
PSObject
Puede canalizar cualquier objeto a out-Printer.
Salidas
None
Out-Printer no devuelve ningún objeto.
Notas
También puede hacer referencia a out-Printer por su alias integrado, lp. Para obtener más información, consulte about_Aliases.
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 Out, el cmdlet lo envía a un cmdlet de formato antes de representarlo.
Los cmdlets Out no tienen parámetros para nombres o rutas de acceso de archivo. Para enviar datos a un cmdlet Out, use un operador de canalización (|) para enviar la salida de un comando de Windows PowerShell al cmdlet . También puede almacenar datos en una variable y usar el parámetro InputObject para pasar los datos al cmdlet. Para obtener más información, consulte los ejemplos.
out-Printer envía datos, pero no emite ningún objeto de salida. Si canaliza la salida de out-Printer a Get-Member, Get-Member informa de que no se han especificado objetos.