Tee-Object

Ссылка

Модуль:: Microsoft.PowerShell.Utility

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

Синтаксис

Tee-Object
   [-InputObject <PSObject>]
   [-FilePath] <String>
   [-Append]
   [<CommonParameters>]

Tee-Object
   [-InputObject <PSObject>]
   -LiteralPath <String>
   [<CommonParameters>]

Tee-Object
   [-InputObject <PSObject>]
   -Variable <String>
   [<CommonParameters>]

Описание

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

Примеры

Пример 1. Выходные процессы в файл и консоль

В этом примере возвращается список процессов, выполняемых на компьютере, и результат отправляется в файл. Так как второй путь не указан, процессы также отображаются в консоли.

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. Выходные процессы в переменную и Select-Object

В этом примере получается список процессов, выполняемых на компьютере, сохраняет их в $proc переменную и передает их Select-Objectв .

Get-Process notepad | Tee-Object -Variable proc | Select-Object processname,handles

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

Командлет Select-Object выбирает свойства ProcessName и Handles . Обратите внимание, что $proc переменная содержит сведения по умолчанию, возвращаемые Get-Process.

Пример 3. Вывод системных файлов в два файла журнала

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

Get-ChildItem -Path D: -File -System -Recurse |
  Tee-Object -FilePath "c:\test\AllSystemFiles.txt" -Append |
    Out-File c:\test\NewSystemFiles.txt

Команда использует Get-ChildItem командлет для рекурсивного поиска системных файлов на диске D: . Оператор конвейера (|) отправляет список, в Tee-Objectкоторый добавляется список в файл AllSystemFiles.txt и передает список вниз по конвейеру Out-File командлету, который сохраняет список в файле NewSystemFiles.txt.

Параметры

-Append

Указывает, что командлет добавляет выходные данные в указанный файл. Без этого параметра новое содержимое заменяет все существующее содержимое файла без предупреждения.

Этот параметр впервые появился в Windows PowerShell 3.0.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FilePath

Указывает файл, который этот командлет сохраняет объект в подстановочные знаки, но должен разрешаться в один файл.

Type:	String
Aliases:	Path
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	True

-InputObject

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

При использовании параметра InputObject вместо Tee-Objectрезультатов команды piping в Tee-Objectзначение InputObject обрабатывается как один объект, даже если значение является коллекцией.

Type:	PSObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-LiteralPath

Указывает файл, в который этот командлет сохраняет объект. В отличие от FilePath значение параметра LiteralPath используется именно в том виде, в котором оно вводится. Никакие символы не интерпретируются как знаки подстановки. Если путь содержит escape-символы, заключите его в одинарные кавычки. Одинарные кавычки сообщают PowerShell, что никакие символы не интерпретируются как escape-последовательности.

Type:	String
Aliases:	PSPath, LP
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Variable

Указывает переменную, в которую командлет сохраняет объект. Введите имя переменной без предыдущего знака доллара ($).

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

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

PSObject

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

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