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

Синтаксис

Out-Printer [[-Name] <string>] [-InputObject <psobject>] [<CommonParameters>]

Описание

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

Параметры

-InputObject <psobject>

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

Обязательно?

false

Позиция?

named

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

Принимать входные данные из конвейера?

true (ByValue)

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

false

-Name <string>

Указывает альтернативный принтер. Имя параметра ("Name") указывать необязательно.

Обязательно?

false

Позиция?

1

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

Принимать входные данные из конвейера?

false

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

false

<CommonParameters>

Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.

Ввод и вывод

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

Входные данные

System.Management.Automation.PSObject

Любой объект можно передать командлету Out-Printer по конвейеру.

Выходные данные

Нет

Командлет Out-Printer не возвращает никаких объектов.

Примечания

Командлет Out-Printer также можно вызывать с помощью встроенного псевдонима "lp". Дополнительные сведения см. в разделе About_Aliases.

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

Командлеты Out не содержат параметров для указания имен или путей. Для передачи данных командлету Out используйте оператор конвейера (|), чтобы передать выходные данные команды Windows PowerShell командлету. Также можно хранить данные в переменной и использовать параметр InputObject для передачи данных в командлет. Дополнительные сведения см. в примерах.

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

Пример 1

C:\PS>get-content $pshome\about_signing.help.txt | Out-Printer

Описание
-----------
Эта команда отправляет содержимое файла справки about_Signing на принтер по умолчанию. Этот пример показывает, как распечатать файл, даже если командлет Out-Printer не имеет параметра Path.

Для получения содержимого файла справки в этой команде используется командлет Get-Content. Путь к файлу включает встроенную переменную $pshome, в которой хранится установочный каталог Windows PowerShell. Оператор конвейера (|) передает результаты командлету Out-Printer, который отправляет их на принтер по умолчанию.






Пример 2

C:\PS>"Hello, World" | out-printer -name "\\Server01\Prt-6B Color"

Описание
-----------
Эта команда печатает фразу "Hello, World" на принтере "Prt-6B Color", установленном в системе Server01. Параметр Name в этой команде используется для указания альтернативного принтера. Имя этого параметра указывать необязательно.






Пример 3

C:\PS>$h = get-help -full get-wmiobject

C:\PS> out-printer -inputobject $h

Описание
-----------
Эти команды печатают полную версию справки по командлету Get-WmiObject. Первая команда получает с помощью командлета Get-Help полную версию справки по командлету Get-WmiObject и сохраняет ее в переменной $h. Вторая команда отправляет полученные сведения принтеру по умолчанию. Для передачи значения переменной $h командлету Out-Printer используется параметр InputObject.






См. также




Содержание