Out-Printer
Invia l'output a una stampante.
Sintassi
Default (Impostazione predefinita)
Out-Printer
[[-Name] <String>]
[-InputObject <PSObject>]
[<CommonParameters>]
Descrizione
Questo cmdlet è disponibile solo nella piattaforma Windows.
Il cmdlet Out-Printer invia l'output alla stampante predefinita o a una stampante alternativa, se specificato.
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 reindirizzare qualsiasi oggetto a Out-Printer.
Output
None
Out-Printer non restituisce alcun oggetto.
Note
Questo cmdlet è disponibile solo nelle piattaforme Windows.
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.