Сохраняет выходные данные команды в файле или переменной и отображает их на консоли.

Синтаксис

Tee-Object [-FilePath] <string> [-InputObject <psobject>] [<CommonParameters>]

Tee-Object -Variable <string> [-InputObject <psobject>] [<CommonParameters>]

Описание

Командлет Tee-Object передает вывод команды по двум направлениям (как у буквы "T"). Он сохраняет вывод в файле или переменной, а также передает его по конвейеру. Если командлет Tee-Object является последним в конвейере, то вывод команды отображается на консоли.

Параметры

-FilePath <string>

Задает файл, в котором командлет сохраняет объект. Принимает подстановочные знаки, которые разрешаются в единственный файл.

Обязательно?	true
Позиция?	1
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-InputObject <psobject>

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

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	true (ByValue)
Принимать подстановочные знаки?	false

-Variable <string>

Присваивает ссылку на объекты ввода указанной переменной.

Обязательно?	true
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

<CommonParameters>

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

Ввод и вывод

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

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

System.Management.Automation.PSObject

Объекты для перенаправления можно передать командлету Tee-Object по конвейеру.

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

System.Management.Automation.PSObject

Командлет Tee-Object возвращает перенаправляемый им объект.

Примечания

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

При записи в файл командлет Tee-Object использует кодировку Юникод. В результате вывод может быть неправильно отформатирован в файлах с другой кодировкой. Для указания кодировки используйте командлет Out-File.

Пример 1

C:\PS>get-process | tee-object -filepath C:\Test1\testfile2.txt 

Handles  NPM(K)	PM(K)	WS(K) VM(M)   CPU(s)	Id ProcessName
-------  ------	-----	----- -----   ------	-- -----------
   83	 4	 2300	 4520	39	 0.30	4032 00THotkey
  272	 6	 1400	 3944	34	 0.06	3088 alg
   81	 3	804	 3284	21	 2.45	 148 ApntEx
   81	 4	 2008	 5808	38	 0.75	3684 Apoint
...

Описание
-----------
Эта команда получает список выполняемых на компьютере процессов и отправляет результат в файл. Поскольку второй путь не указан, результат будет выведен на консоль.

Пример 2

C:\PS>get-process notepad | tee-object -variable proc | select-object processname,handles 

ProcessName							Handles
-----------							-------
notepad								43
notepad								37
notepad								38
notepad								38

Описание
-----------
Эта команда получает список выполняемых на компьютере процессов и сохраняет результат в переменной "proc". После этого полученные объекты передаются по конвейеру командлету Select-Object, который выбирает свойства ProcessName и Handles. Обратите внимание, что переменная $proc включает сведения по умолчанию, возвращенные командлетом Get-Process.

Tee-Object