Out-Printer
Invia l'output a una stampante.
Sintassi
Default (Impostazione predefinita)
Out-Printer
[[-Name] <String>]
[-InputObject <PSObject>]
[<CommonParameters>]
Descrizione
Il cmdlet Out-Printer invia l'output alla stampante predefinita o a una stampante alternativa, se specificato. Poiché il cmdlet non ha modo di configurare il processo di stampa, il processo di stampa risultante usa le impostazioni predefinite definite per la stampante.
Annotazioni
Questo cmdlet è stato reintrodotto in PowerShell 7. Questo cmdlet è disponibile solo nei sistemi Windows che supportano Windows Desktop.
Esempio
Esempio 1 - Inviare un file da stampare sulla stampante predefinita
In questo esempio viene illustrato come stampare un file, anche se Out-Printer non dispone di un parametro Path.
Get-Content -Path ./readme.txt | Out-Printer
Get-Contentottiene il contenuto del file readme.txt nella directory corrente e lo invia tramite pipe a Out-Printer, che lo invia alla stampante predefinita.
Esempio 2: Stampare una stringa in una stampante remota
In questo esempio, Hello, World viene stampato su prt-6B la stampante a colori su Server01.
"Hello, World" | Out-Printer -Name "\\Server01\Prt-6B Color"
Il parametro Nome seleziona una stampante specifica anziché quella predefinita.
Esempio 3 - Stampare un argomento di aiuto sulla stampante predefinita
In questo esempio viene stampata la versione completa dell'argomento della Guida per Get-CimInstance.
$H = Get-Help -Full Get-CimInstance
Out-Printer -InputObject $H
Get-Help ottiene la versione completa dell'argomento della Guida per Get-CimInstance e la archivia nella variabile $H. Il parametro InputObject passa il valore di $H a Out-Printer.
Parametri
-InputObject
Specifica gli oggetti da inviare alla stampante. Immettere una variabile contenente gli oggetti oppure digitare un comando o un'espressione che ottiene gli oggetti .
Proprietà dei parametri
| Tipo: | PSObject |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Name
Invia l'output alla stampante specificata. Il nome del parametro nome è facoltativo.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | PrinterName |
Set di parametri
(All)
| Posizione: | 0 |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Input
PSObject
È possibile passare qualsiasi oggetto come input a questo cmdlet.
Output
None
Questo cmdlet non restituisce alcun output.
Note
Windows PowerShell include gli alias seguenti per Out-Printer:
lp
I cmdlet che contengono il verbo Out non formattano gli oggetti. Eseguono semplicemente il rendering e li inviano alla destinazione di visualizzazione specificata. Se si invia un oggetto non formattato a un cmdlet di Out, il cmdlet lo invia a un cmdlet di formattazione prima di eseguire il rendering.
Out-Printer invia dati alla stampante, ma non genera oggetti di output nella pipeline. Se si invia tramite pipe l'output di Out-Printer a Get-Member, Get-Member segnala che non sono stati specificati oggetti.