Out-Printer
Envía la salida a una impresora.
Sintaxis
Default (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.
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 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
Envía la salida a la impresora especificada. 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
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.