Out-Printer (Microsoft.PowerShell.Utility)

Out-Printer

Модуль:

Microsoft.PowerShell.Utility

Отправляет вывод на принтер.

Синтаксис

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

Описание

Этот командлет доступен только на платформе Windows.

Командлет Out-Printer отправляет выходные данные на принтер по умолчанию или на альтернативный принтер, если он указан. Поскольку командлет не имеет возможности настроить задание печати, в итоговом задании печати используются настройки по умолчанию, определенные для принтера.

Примеры

Пример 1. Отправка файла на печать на принтере по умолчанию.

В этом примере показано, как распечатать файл, даже если Out-Printer не имеет параметра Path.

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

Get-Content получает содержимое файла readme.txt в текущем каталоге и передает его в Out-Printer, который отправляет его в принтер по умолчанию.

Пример 2. Печать строки на удаленном принтере

В этом примере текст Hello, World печатается на принтере Prt-6B Color на сервере Server01.

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

Параметр Name выбирает конкретный принтер, а не принтер по умолчанию.

Пример 3. Распечатка раздела справки на принтере по умолчанию.

В этом примере печатается полная версия раздела справки для Get-CimInstance.

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

Get-Help получает полную версию раздела справки для Get-CimInstance и сохраняет ее в переменной $H. Параметр InputObject передает значение $H в Out-Printer.

Параметры

-InputObject

Указывает объекты, которые будут отправлены на принтер. Введите переменную, содержащую объекты, или введите команду или выражение, позволяющее получить объекты.

Тип :

PSОбъект

Позиция:

Именованный

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

True

Принимайте подстановочные знаки:

False

-Name

Отправляет выходные данные на указанный принтер. Имя параметра Name не является обязательным.

Тип :

String

Псевдонимы:

PrinterName

Позиция:

0

Значение по умолчанию:

None

Необходимый:

False

Примите ввод конвейера:

False

Принимайте подстановочные знаки:

False

Входы

PSObject

В этот командлет можно передать любой объект.

Выходы

Нет

Этот командлет не возвращает никаких результатов.

Примечания

Этот командлет доступен только на платформах Windows.

Командлеты, содержащие команду Out, не форматируют объекты. Они просто визуализируют их и отправляют в указанное место отображения. Если вы отправляете неформатированный объект в командлет Out, командлет отправляет его в командлет форматирования перед его обработкой.

Out-Printer отправляет данные на принтер, но не отправляет выходные объекты в конвейер. Если вы передаете выходные данные Out-Printer в Get-Member, Get-Member сообщает, что никакие объекты не указаны.