Out-Printer
Invia l'output a una stampante.
Sintassi
Out-Printer [[-Name] <string>] [-InputObject <psobject>] [<CommonParameters>]
Descrizione
Il cmdlet Out-Printer consente di inviare l'output alla stampante predefinita o a una stampante alternativa, se ne è stata specificata una.
Parametri
-InputObject <psobject>
Specifica gli oggetti da inviare alla stampante. Immettere una variabile contenente gli oggetti oppure digitare un comando o un'espressione che consente di ottenere gli oggetti.
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
|
Accettare input da pipeline? |
true (ByValue) |
Accettare caratteri jolly? |
false |
-Name <string>
Specifica la stampante alternativa. Il nome del parametro ("Name") è facoltativo.
Obbligatorio? |
false |
Posizione? |
1 |
Valore predefinito |
|
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
<CommonParameters>
Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.
Input e output
Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.
Input |
System.Management.Automation.PSObject È possibile reindirizzare qualsiasi oggetto a Out-Printer. |
Output |
Nessuno Out-Printer non restituisce alcun oggetto. |
Note
È inoltre possibile fare riferimento a Out-Printer tramite il relativo alias predefinito "lp". Per ulteriori informazioni, vedere about_Aliases.
I cmdlet che contengono il verbo Out (cmdlet Out) non consentono di formattare gli oggetti ma solo di eseguirne il rendering e di inviarli alla destinazione di visualizzazione specificata. Un oggetto non formattato inviato a un cmdlet di tipo Out verrà inviato a un cmdlet di formattazione prima di eseguirne il rendering.
Con i cmdlet di tipo Out non sono disponibili parametri per nomi o percorsi di file. Per inviare i dati a un cmdlet Out, utilizzare un operatore pipeline (|) per inviare l'output di un comando di Windows PowerShell al cmdlet. È inoltre possibile archiviare i dati in una variabile e utilizzare il parametro InputObject per passare i dati al cmdlet. Per ulteriori informazioni, vedere gli esempi.
Out-Printer invia i dati ma non crea oggetti di output. Se si reindirizza l'output di Out-Printer a Get-Member, Get-Member segnalerà che non sono stati specificati oggetti.
Esempio 1
C:\PS>get-content $pshome\about_signing.help.txt | Out-Printer
Descrizione
-----------
Tramite questo comando il contenuto dell'argomento della Guida about_Signing verrà stampato sulla stampante predefinita. Nell'esempio verrà illustrato come stampare un file anche se non si specifica un parametro Path per Out-Printer.
Nel comando viene utilizzato il cmdlet Get-Content per ottenere il contenuto dell'argomento della Guida. Il percorso include $pshome, una variabile predefinita in cui è archiviata la directory di installazione di Windows PowerShell. Verrà utilizzato un operatore pipeline (|) per passare i risultati a Out-Printer, che li invierà alla stampante predefinita.
Esempio 2
C:\PS>"Hello, World" | out-printer -name "\\Server01\Prt-6B Color"
Descrizione
-----------
Con questo comando viene stampato il testo "Hello, World" sulla stampante "Prt-6B Color" disponibile su Server01. Per specificare la stampante alternativa, verrà utilizzato il parametro Name. Il nome del parametro è facoltativo, pertanto può essere omesso.
Esempio 3
C:\PS>$h = get-help -full get-wmiobject
C:\PS> out-printer -inputobject $h
Descrizione
-----------
Tramite questi comandi verrà stampata la versione completa dell'argomento della Guida relativo a Get-WmiObject. Nel primo comando verrà utilizzato il cmdlet Get-Help per ottenere la versione completa dell'argomento della Guida relativo a Get-WmiObject che verrà quindi archiviata nella variabile $h. Tramite il secondo comando il contenuto verrà inviato alla stampante predefinita. Verrà utilizzato il parametro InputObject per passare il valore della variabile $h a Out-Printer.