Out-Printer
Envía la salida a una impresora.
Sintaxis
Default (Es el valor predeterminado).
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.
Propiedades del parámetro
| Tipo: | PSObject |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Name
Envía la salida a la impresora especificada. El nombre del parámetro Nombre es opcional.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | PrinterName |
Conjuntos de parámetros
(All)
| Posición: | 0 |
| Mandatory: | 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 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.
