Out-Printer
Envoie la sortie à une imprimante.
Syntaxe
Default (Par défaut)
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, 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 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 dirige vers Out-Printer, qui l’envoie à l’imprimante par défaut.
Exemple 2 : Imprimer une chaîne sur une imprimante distante
Cet exemple montre comment Hello, World imprimer l’imprimante De 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 transmet la valeur à $HOut-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.
Propriétés du paramètre
| Type: | PSObject |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Name
Envoie la sortie à l’imprimante spécifiée. Le nom du paramètre est facultatif.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | PrinterName |
Jeux de paramètres
(All)
| Position: | 0 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
Entrées
PSObject
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 Out verbe 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 Out applet de commande, 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 dans le pipeline. Si vous dirigez la sortie vers Out-PrinterGet-Member, Get-Member signale qu’aucun objet n’a été spécifié.
