Partager via

Out-Printer

  • Référence
Module:
Microsoft.PowerShell.Utility

Envoie la sortie vers une imprimante.

Syntax

Out-Printer
   [[-Name] <String>]
   [-InputObject <PSObject>]
   [<CommonParameters>]

Description

Cette applet de commande est disponible uniquement sur la plateforme Windows.

L’applet Out-Printer de commande envoie la sortie à l’imprimante par défaut ou à une autre imprimante, le cas échéant. Étant donné que l’applet de commande n’a aucun moyen de configurer le travail d’impression, le travail d’impression résultant utilise les paramètres par défaut définis pour l’imprimante.

Notes

Cette applet de commande a été réintroduite dans PowerShell 7. Cette applet de commande est disponible uniquement sur les systèmes Windows qui prennent en charge windows Desktop.

Exemples

Exemple 1 - Envoyer un fichier à imprimer sur l’imprimante par défaut

Cet exemple montre comment imprimer un fichier, même s’il Out-Printer n’a pas de paramètre Path .

Get-Content -Path ./readme.txt | Out-Printer

Get-Contentobtient le contenu du readme.txt fichier dans le répertoire actif et le redirige vers Out-Printer, ce qui l’envoie à l’imprimante par défaut.

Exemple 2 : Imprimer une chaîne sur une imprimante distante

Cet exemple imprime Hello, World sur l’imprimante Couleur Prt-6B sur Server01.

"Hello, World" | Out-Printer -Name "\\Server01\Prt-6B Color"

Le paramètre Name sélectionne une imprimante spécifique, plutôt que la valeur par défaut.

Exemple 3 - Imprimer une rubrique d’aide sur l’imprimante par défaut

Cet exemple imprime la version complète de la rubrique d’aide pour Get-CimInstance.

$H = Get-Help -Full Get-CimInstance
Out-Printer -InputObject $H

Get-Help obtient la version complète de la rubrique d’aide pour Get-CimInstance et la stocke dans la $H variable . Le paramètre InputObject passe la valeur de $H à Out-Printer.

Paramètres

-InputObject

Spécifie les objets à envoyer à l'imprimante. Entrez une variable contenant les objets, ou tapez une commande ou une expression qui obtient ces objets.

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Envoie la sortie à l’imprimante spécifiée. Le nom du paramètre Name est facultatif.

Type:String
Aliases:PrinterName
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

PSObject

Vous pouvez diriger n’importe quel objet vers cette applet de commande.

Sorties

None

Cette applet de commande ne retourne pas de sortie.

Notes

Cette applet de commande est disponible uniquement sur les plateformes Windows.

Les applets de commande qui contiennent le Out verbe ne mettez pas en forme les objets. Ils les restituent et les envoient à la destination d’affichage spécifiée. Si vous envoyez un objet non mis en forme à une applet de Out commande, l’applet de commande l’envoie à une applet de commande de mise en forme avant de le rendre.

Out-Printer envoie des données à l’imprimante, mais n’émet aucun objet de sortie vers le pipeline. Si vous dirigez la sortie de Out-Printer vers Get-Member, Get-Member signale qu’aucun objet n’a été spécifié.