Dela via

Tee-Object

Modul:
Microsoft.PowerShell.Utility Module

Sparar kommandoutdata i en fil eller variabel och skickar den även nedåt i pipelinen.

Syntax

File (Standard) 

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

LiteralFile 

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

Variable 

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

Description

Cmdleten Tee-Object skriver utdata i två riktningar. Den lagrar utdata i en fil eller variabel och skickar den även nedåt i pipelinen. Om Tee-Object är det sista kommandot i pipelinen visas kommandoutdata i konsolen.

Tee-Object Internt använder kommandona Set-Variable ochOut-File. Dessa kommandon stöder parametern WhatIf . Kommandot Tee-Object stöder inte parametern WhatIf . Men om du omsluter Tee-Object i ett skript eller en funktion som stöder parametern WhatIf skickar Tee-Object du tillståndet för WhatIf till Set-Variable kommandona och Out-File .

Exempel

Exempel 1: Utdataprocesser till en fil och till konsolen

Det här exemplet hämtar en lista över de processer som körs på datorn och skickar resultatet till en fil. Eftersom en andra sökväg inte har angetts visas även processerna i konsolen.

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
...

Exempel 2: Utdataprocesser till en variabel och "Select-Object"

Det här exemplet hämtar en lista över de processer som körs på datorn, sparar dem i variabeln $proc och skickar dem till Select-Object.

Get-Process notepad | Tee-Object -Variable proc | Select-Object ProcessName, Handles

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

Cmdleten Select-Object väljer egenskaperna ProcessName och Handles. Observera att variabeln $proc innehåller standardinformationen som returneras av Get-Process.

Exempel 3: Mata ut systemfiler till två loggfiler

I det här exemplet sparas en lista över systemfiler i två loggfiler, en kumulativ fil och en aktuell fil.

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

Kommandot använder cmdleten Get-ChildItem för att göra en rekursiv sökning efter systemfiler på D:-enheten. En pipelineoperator (|) skickar listan till Tee-Object, som lägger till listan i AllSystemFiles.txt-filen och skickar listan nedåt i pipelinen till cmdleten Out-File, vilket sparar listan i NewSystemFiles.txt file.

Exempel 4: Använd "Tee-Object" i ett skript med parametern **WhatIf**

Kommandot Tee-Object stöder inte parametern WhatIf . Men om du omsluter Tee-Object ett skript eller en funktion som stöder parametern WhatIf skickar Tee-Object du tillståndet för WhatIf till kommandona Set-Variable och Out-File som används internt.

PS> function Test-Tee {
    [Cmdletbinding(SupportsShouldProcess)]
    Param()
    $true|tee -Variable b
    "Variable `$b is set to '$b'"
}

PS> Test-Tee

True
Variable $b is set to 'True'

PS> Test-Tee -WhatIf
True
What if: Performing the operation "Set variable" on target "Name: b Value: True".
Variable $b is set to ''

Parametrar

-Append

Anger att cmdleten lägger till utdata till den angivna filen. Utan den här parametern ersätter det nya innehållet befintligt innehåll i filen utan varning.

Den här parametern introducerades i Windows PowerShell 3.0.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

File
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-FilePath

Anger en fil som den här cmdleten sparar objektet till Jokertecken tillåts, men måste matcha till en enda fil.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:True
DontShow:False

Parameteruppsättningar

File
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-InputObject

Anger det objekt som ska sparas och visas. Ange en variabel som innehåller objekten eller skriv ett kommando eller uttryck som hämtar objekten. Du kan också skicka ett objekt till Tee-Object.

När du använder parametern InputObject med Tee-Object, i stället för att skicka kommandoresultat till Tee-Object, behandlas värdet InputObject som ett enda objekt även om värdet är en samling.

Parameteregenskaper

Typ:PSObject
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-LiteralPath

Anger en fil som den här cmdleten sparar objektet till. Till skillnad från FilePathanvänds värdet för parametern LiteralPath precis som det skrivs. Inga tecken tolkas som wildcards. Om sökvägen innehåller escape-tecken omger du den med enkla citattecken. Enkla citattecken gör att PowerShell inte tolkar några tecken som escape-sekvenser.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:PSPath

Parameteruppsättningar

LiteralFile
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Variable

Anger en variabel som cmdleten sparar objektet till. Ange ett variabelnamn utan föregående dollartecken ($).

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

Variable
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

PSObject

Du kan skicka objekt till den här cmdleten.

Utdata

PSObject

Den här cmdleten returnerar det objekt som omdirigeras.

Kommentarer

Windows PowerShell innehåller följande alias för Tee-Object:

  • tee

Du kan också använda cmdleten Out-File eller omdirigeringsoperatorn, som båda sparar utdata i en fil men inte skickar dem i pipelinen.

Tee-Object använder "Unicode" (UTF-16LE) kodning när den skriver till filer. Om du behöver en annan kodning använder du cmdleten Out-File med parametern Kodning.