Out-Printer
Envoie la sortie à une imprimante.
Syntaxe
Out-Printer [[-Name] <string>] [-InputObject <psobject>] [<CommonParameters>]
Description
L'applet de commande Out-Printer envoie la sortie à l'imprimante par défaut ou à une autre imprimante, si celle-ci est spécifiée.
Paramètres
-InputObject <psobject>
Spécifie les objets à envoyer à l'imprimante. Entrez une variable contenant les objets, ou tapez une commande ou une expression permettant d'obtenir ces objets.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
true (ByValue) |
Accepter les caractères génériques ? |
false |
-Name <string>
Spécifie l'autre imprimante. Le nom de paramètre (« Name ») est facultatif.
Obligatoire ? |
false |
Position ? |
1 |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.
Entrées et sorties
Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.
Entrées |
System.Management.Automation.PSObject Vous pouvez diriger n'importe quel objet vers Out-Printer. |
Sorties |
Aucun Out-Printer ne retourne aucun objet. |
Remarques
Vous pouvez également faire référence à Out-Printer par son alias intégré, « lp ». Pour plus d'informations, consultez about_Aliases.
Les applets de commande contenant le verbe Out (les applets de commande Out) ne mettent pas en forme les objets ; elles les restituent seulement 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 le restituer.
Les applets de commande Out n'ont pas de paramètres pour les noms ou les chemins d'accès aux fichiers. Pour envoyer des données à une applet de commande Out, utilisez un opérateur de pipeline (|) pour envoyer la sortie d'une commande Windows PowerShell à l'applet de commande. Vous pouvez également stocker des données dans une variable et utiliser le paramètre InputObject pour passer les données à l'applet de commande. Pour plus d'informations, consultez les exemples.
Out-Printer envoie des données, mais n'émet pas d'objets de sortie. Si vous dirigez la sortie d'Out-Printer vers Get-Member, Get-Member indique qu'aucun objet n'a été spécifié.
Exemple 1
C:\PS>get-content $pshome\about_signing.help.txt | Out-Printer
Description
-----------
Cette commande imprime le contenu de la rubrique d'aide about_Signing sur l'imprimante par défaut. Cet exemple vous montre comment imprimer un fichier, bien qu'Out-Printer n'ait pas de paramètre Path.
La commande utilise l'applet de commande Get-Content pour obtenir le contenu de la rubrique d'aide. Le chemin d'accès inclut $pshome, une variable intégrée qui stocke le répertoire d'installation pour Windows PowerShell. Un opérateur de pipeline (|) passe les résultats à Out-Printer, qui les envoie à l'imprimante par défaut.
Exemple 2
C:\PS>"Hello, World" | out-printer -name "\\Server01\Prt-6B Color"
Description
-----------
Cette commande imprime « Hello, World » sur l'imprimante « Prt-6B Color » du Server01. Elle utilise le paramètre Name pour spécifier l'autre imprimante. Dans la mesure où le nom du paramètre est facultatif, vous pouvez l'omettre.
Exemple 3
C:\PS>$h = get-help -full get-wmiobject
C:\PS> out-printer -inputobject $h
Description
-----------
Ces commandes impriment la version complète de la rubrique d'aide de Get-WmiObject. La première commande utilise l'applet de commande Get-Help pour obtenir la version complète de la rubrique d'aide de Get-WmiObject, et la stocke dans la variable $h. La seconde commande envoie le contenu à l'imprimante par défaut. Elle utilise le paramètre InputObject pour passer la valeur de la variable $h à Out-Printer.