Condividi tramite


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.