Поделиться через


Out-Printer

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

Синтаксис

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

Описание

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

Примеры

Пример 1. Печать содержимого раздела справки на принтер по умолчанию

PS C:\> Get-Content $pshome\about_signing.help.txt | Out-Printer

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

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

Пример 2. Печать текста на альтернативный принтер

PS C:\> "Hello, World" | Out-Printer -Name "\\Server01\Prt-6B Color"

Эта команда выводит Hello, World на принтер Цвета Prt-6B на Server01. Эта команда использует параметр Name для указания альтернативного принтера. Так как имя параметра является необязательным, его можно опустить.

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

PS C:\> $H = Get-Help -Full Get-WmiObject
PS C:\> Out-Printer -InputObject $H

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

Параметры

-InputObject

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

Тип:PSObject
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Name

Указывает альтернативный принтер. Имя параметра Имя является необязательным.

Тип:String
Aliases:PrinterName
Position:0
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

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

PSObject

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

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

None

out-Printer не возвращает объекты.

Примечания

  • Вы также можете ссылаться на out-Printer с помощью встроенного псевдонима lp. Дополнительные сведения см. в about_Aliases.

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

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

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