Out-Printer
Envoie la sortie à une imprimante.
Syntaxe
Out-Printer
[[-Name] <String>]
[-InputObject <PSObject>]
[<CommonParameters>]Description
Cette applet de commande est disponible uniquement sur la plateforme Windows.
L’applet de commande Out-Printer envoie la sortie à l’imprimante par défaut ou à une autre imprimante, si elle est spécifiée. Étant donné que l’applet de commande n’a aucun moyen de configurer la tâche d’impression, la tâche d’impression résultante utilise les paramètres par défaut définis pour l’imprimante.
Note
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 le Bureau Windows.
Exemples
Exemple 1 : Envoyer un fichier à imprimer sur l’imprimante par défaut
Cet exemple montre comment imprimer un fichier, même si Out-Printer n’a pas de paramètre Path.
Get-Content -Path ./readme.txt | Out-Printer
Get-Contentobtient le contenu du fichier readme.txt dans le répertoire actif et le dirige vers Out-Printer, 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 montre comment imprimer 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 variable $H. Le paramètre InputObject transmet la valeur de $H à Out-Printer.
Paramètres
-InputObject
Spécifie les objets à envoyer à l’imprimante. Entrez une variable qui contient les objets, ou tapez une commande ou une expression qui obtient les objets.
| Type: | PSObject |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
-Name
Envoie la sortie à l’imprimante spécifiée. Le nom du paramètre Nom est facultatif.
| Type: | String |
| Alias: | PrinterName |
| Position: | 0 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
Entrées
Vous pouvez diriger n’importe quel objet vers cette applet de commande.
Sorties
None
Cette applet de commande ne retourne aucune sortie.
Notes
Cette applet de commande est disponible uniquement sur les plateformes Windows.
Les applets de commande qui contiennent le verbe Out ne mettez pas en forme les objets. Ils les affichent simplement et les envoient à la destination d’affichage spécifiée. Si vous envoyez un objet non mis en forme à une applet de commande Out, l’applet de commande l’envoie à une applet de commande de mise en forme avant de la 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é.
