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 specificata.
Esempio
Esempio 1: Stampa il contenuto di un argomento della Guida sulla stampante predefinita
PS C:\> Get-Content $pshome\about_signing.help.txt | Out-Printer
Questo comando consente di stampare il contenuto dell'argomento della Guida about_Signing sulla stampante predefinita. In questo esempio viene illustrato come stampare un file, anche se Out-Printer non dispone di un parametro Path .
Il comando utilizza il cmdlet Get-Content per ottenere il contenuto dell'argomento della Guida. Il percorso include $pshome, una variabile incorporata che memorizza la directory di installazione per Windows PowerShell. Un operatore pipeline (|) passa i risultati a Out-Printer, che li invia alla stampante predefinita.
Esempio 2: Stampa di testo su una stampante alternativa
PS C:\> "Hello, World" | Out-Printer -Name "\\Server01\Prt-6B Color"
Questo comando stampa Hello, World sulla stampante a colori Prt-6B su Server01. Questo comando utilizza il parametro Name per specificare la stampante alternativa. Poiché il nome del parametro è facoltativo, è possibile ometterlo.
Esempio 3: Stampa la versione completa di un argomento della Guida sulla stampante predefinita
PS C:\> $H = Get-Help -Full Get-WmiObject
PS C:\> Out-Printer -InputObject $H
Questi comandi consentono di stampare la versione completa dell'argomento della Guida per Get-WmiObject. Il primo comando utilizza il cmdlet Get-Help per ottenere la versione completa dell'argomento della Guida per Get-WmiObject e la archivia nella variabile $H. Il secondo comando invia il contenuto alla stampante predefinita. Utilizza il parametro InputObject per passare il valore della variabile $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
Specifica la stampante alternativa. 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
È inoltre possibile fare riferimento a Out-Printer tramite l'alias incorporato, lp. Per altre informazioni, vedere about_Aliases.
I cmdlet che contengono il verbo Out non formattano gli oggetti. Ne eseguono semplicemente il rendering e li inviano alla destinazione di visualizzazione specificata. Se si invia un oggetto non formattato a un cmdlet Out, il cmdlet lo invia a un cmdlet di formattazione prima di eseguirne il rendering.
I cmdlet Out non dispongono di parametri per i nomi o i percorsi dei file. Per inviare dati a un cmdlet Out, utilizzare un operatore pipeline (|) per inviare l'output di un comando di Windows PowerShell al cmdlet. È anche possibile archiviare i dati in una variabile e usare il parametro
InputObject per passare i dati al cmdlet. Per altre informazioni, vedere gli esempi. Out-Printer invia dati, ma non genera alcun oggetto di output. Se si reindirizza l'output di Out-Printer a Get-Member, Get-Member segnala che non è stato specificato alcun oggetto.