Out-Printer
Отправляет выходные данные на принтер.
Синтаксис
Default (По умолчанию)
Out-Printer
[[-Name] <String>]
[-InputObject <PSObject>]
[<CommonParameters>]
Описание
Командлет Out-Printer отправляет выходные данные на принтер по умолчанию или в альтернативный принтер, если он указан. Так как командлет не имеет способа настроить задание печати, результирующий задание печати использует параметры по умолчанию, определенные для принтера.
Замечание
Этот командлет был повторно введен в PowerShell 7. Этот командлет доступен только в системах Windows, поддерживающих рабочий стол Windows.
Примеры
Пример 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
Указывает объекты, отправляемые на принтер. Введите переменную, содержащую объекты, или введите команду или выражение, которое получает объекты.
Свойства параметров
| Тип: | PSObject |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Name
Отправляет выходные данные на указанный принтер. Имя параметра Имя является необязательным.
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | PrinterName |
Наборы параметров
(All)
| Position: | 0 |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Входные данные
PSObject
Вы можете передать любой объект в этот cmdlet.
Выходные данные
None
Этот командлет не возвращает выходные данные.
Примечания
Windows PowerShell включает следующие псевдонимы для Out-Printer:
lp
Командлеты, содержащие глагол Out, не форматируют объекты. Они просто отрисовывают их и отправляют их в указанное место назначения отображения. Если вы отправляете неформатированный объект в командлет Out, командлет отправляет его в командлет форматирования перед отрисовкой.
Out-Printer отправляет данные на принтер, но не выдает выходные объекты в конвейер. Если вы передаете выходные данные Out-Printer в Get-Member, Get-Member сообщает, что объекты не были указаны.
