Out-Printer
Отправляет вывод на принтер.
Синтаксис
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.