Select-Object
Hiermee selecteert u objecten of objecteigenschappen.
Syntaxis
Select-Object
[[-Property] <Object[]>]
[-InputObject <psobject>]
[-ExcludeProperty <string[]>]
[-ExpandProperty <string>]
[-Unique]
[-Last <int>]
[-First <int>]
[-Skip <int>]
[-Wait]
[<CommonParameters>]
Select-Object
[[-Property] <Object[]>]
[-InputObject <psobject>]
[-ExcludeProperty <string[]>]
[-ExpandProperty <string>]
[-Unique]
[-SkipLast <int>]
[<CommonParameters>]
Select-Object
[-InputObject <psobject>]
[-Unique]
[-Wait]
[-Index <int[]>]
[<CommonParameters>]
Select-Object
[-InputObject <psobject>]
[-Unique]
[-SkipIndex <int[]>]
[<CommonParameters>]
Description
De Select-Object
cmdlet selecteert de opgegeven eigenschappen van een object of set objecten. Het kan ook unieke objecten, een opgegeven aantal objecten of objecten in een opgegeven positie in een matrix selecteren.
Als u objecten uit een verzameling wilt selecteren, gebruikt u de First, Last, Unique, Skipen Index parameters. Als u objecteigenschappen wilt selecteren, gebruikt u de parameter Eigenschap. Wanneer u eigenschappen selecteert, retourneert Select-Object
nieuwe objecten met alleen de opgegeven eigenschappen.
Vanaf Windows PowerShell 3.0 bevat Select-Object
een optimalisatiefunctie waarmee wordt voorkomen dat opdrachten objecten maken en verwerken die niet worden gebruikt.
Wanneer u Select-Object
gebruikt met de parameters First of Index parameters in een opdrachtpijplijn, stopt PowerShell de opdracht waarmee de objecten worden gegenereerd zodra het geselecteerde aantal objecten is bereikt. Als u dit optimalisatiegedrag wilt uitschakelen, gebruikt u de parameter Wait.
Voorbeelden
Voorbeeld 1: Objecten selecteren op eigenschap
In dit voorbeeld worden objecten gemaakt met de eigenschappen Name, IDen werkset (WS-) van procesobjecten.
Get-Process | Select-Object -Property ProcessName, Id, WS
Voorbeeld 2: Objecten selecteren op eigenschap en de resultaten opmaken
In dit voorbeeld wordt informatie opgehaald over de modules die door de processen op de computer worden gebruikt. Er wordt Get-Process
cmdlet gebruikt om het proces op de computer op te halen.
De cmdlet Select-Object
wordt gebruikt om een matrix van [System.Diagnostics.ProcessModule]
exemplaren uit te voeren, zoals opgenomen in de eigenschap Modules van elke System.Diagnostics.Process
exemplaaruitvoer door Get-Process
.
De parameter Eigenschap van de cmdlet Select-Object
selecteert de procesnamen. Hiermee wordt een ProcessName
NoteProperty- toegevoegd aan elke [System.Diagnostics.ProcessModule]
instantie en wordt deze gevuld met de waarde van de eigenschap ProcessName van het huidige proces.
Ten slotte wordt Format-List
cmdlet gebruikt om de naam en modules van elk proces in een lijst weer te geven.
Get-Process Explorer |
Select-Object -Property ProcessName -ExpandProperty Modules |
Format-List
ProcessName : explorer
ModuleName : explorer.exe
FileName : C:\WINDOWS\explorer.exe
BaseAddress : 140697278152704
ModuleMemorySize : 3919872
EntryPointAddress : 140697278841168
FileVersionInfo : File: C:\WINDOWS\explorer.exe
InternalName: explorer
OriginalFilename: EXPLORER.EXE.MUI
FileVersion: 10.0.17134.1 (WinBuild.160101.0800)
FileDescription: Windows Explorer
Product: Microsoft Windows Operating System
ProductVersion: 10.0.17134.1
...
Voorbeeld 3: Processen selecteren die het meeste geheugen gebruiken
In dit voorbeeld worden de vijf processen ophaalt die het meeste geheugen gebruiken. De Get-Process
cmdlet haalt de processen op de computer op. De Sort-Object
cmdlet sorteert de processen op basis van het geheugengebruik (werkset) en de Select-Object
cmdlet selecteert alleen de laatste vijf leden van de resulterende matrix met objecten.
De parameter Wait is niet vereist in opdrachten die de Sort-Object
cmdlet bevatten, omdat Sort-Object
alle objecten verwerkt en vervolgens een verzameling retourneert. De Select-Object
optimalisatie is alleen beschikbaar voor opdrachten die objecten afzonderlijk retourneren wanneer ze worden verwerkt.
Get-Process | Sort-Object -Property WS | Select-Object -Last 5
Handles NPM(K) PM(K) WS(K) VS(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
2866 320 33432 45764 203 222.41 1292 svchost
577 17 23676 50516 265 50.58 4388 WINWORD
826 11 75448 76712 188 19.77 3780 Ps
1367 14 73152 88736 216 61.69 676 Ps
1612 44 66080 92780 380 900.59 6132 INFOPATH
Voorbeeld 4: Unieke tekens uit een matrix selecteren
In dit voorbeeld wordt de parameter Unique van Select-Object
gebruikt om unieke tekens op te halen uit een matrix met tekens.
"a","b","c","a","a","a" | Select-Object -Unique
a
b
c
Voorbeeld 5: '-Unique' gebruiken met andere parameters
De parameterwaarden Unique worden gefilterd nadat andere Select-Object
parameters zijn toegepast. Als u bijvoorbeeld de parameter Eerste gebruikt om het eerste aantal items in een matrix te selecteren, wordt Unieke alleen toegepast op de geselecteerde waarden en niet op de hele matrix.
"a","a","b","c" | Select-Object -First 2 -Unique
a
In dit voorbeeld selecteert Eerste"a","a"
als de eerste 2 items in de matrix.
Unieke wordt toegepast op "a","a"
en retourneert a
als de unieke waarde.
Voorbeeld 6: Nieuwste en oudste gebeurtenissen selecteren in het gebeurtenislogboek
In dit voorbeeld worden de eerste (nieuwste) en laatste (oudste) gebeurtenissen in het Windows PowerShell-gebeurtenislogboek weergegeven.
Get-WinEvent
alle gebeurtenissen in het Windows PowerShell-logboek ophaalt en opslaat in de variabele $a
.
Vervolgens wordt $a
doorgesluisd naar de Select-Object
cmdlet. De opdracht Select-Object
gebruikt de parameter Index om gebeurtenissen te selecteren uit de matrix met gebeurtenissen in de $a
variabele. De index van de eerste gebeurtenis is 0. De index van de laatste gebeurtenis is het aantal items in $a
min 1.
$a = Get-WinEvent -LogName "Windows PowerShell"
$a | Select-Object -Index 0, ($a.count - 1)
Voorbeeld 7: Alles behalve het eerste object selecteren
In dit voorbeeld wordt een nieuwe PSSession gemaakt op elk van de computers die worden vermeld in de Servers.txt bestanden, met uitzondering van de eerste.
Select-Object
selecteert alle computers behalve de eerste computer in een lijst met computernamen. De resulterende lijst met computers wordt ingesteld als de waarde van de parameter ComputerName van de New-PSSession
-cmdlet.
New-PSSession -ComputerName (Get-Content Servers.txt | Select-Object -Skip 1)
Voorbeeld 8: De naam van bestanden wijzigen en een aantal selecteren om te controleren
In dit voorbeeld wordt een achtervoegsel '-ro' toegevoegd aan de basisnamen van tekstbestanden met het kenmerk Alleen-lezen en worden vervolgens de eerste vijf bestanden weergegeven, zodat de gebruiker een voorbeeld van het effect kan zien.
Get-ChildItem
gebruikt de dynamische parameter ReadOnly om alleen-lezenbestanden op te halen. De resulterende bestanden worden doorgesluisd naar de Rename-Item
cmdlet, die de naam van het bestand wijzigt. Hierbij wordt de parameter PassThru van Rename-Item
gebruikt om de hernoemde bestanden te verzenden naar de Select-Object
-cmdlet, waarmee de eerste 5 voor weergave wordt geselecteerd.
De parameter Wait van Select-Object
voorkomt dat PowerShell de Get-ChildItem
cmdlet stopt nadat de eerste vijf alleen-lezen tekstbestanden zijn opgehaald. Zonder deze parameter worden alleen de eerste vijf alleen-lezenbestanden hernoemd.
Get-ChildItem *.txt -ReadOnly |
Rename-Item -NewName {$_.BaseName + "-ro.txt"} -PassThru |
Select-Object -First 5 -Wait
Voorbeeld 9: De complexiteit van de parameter -ExpandProperty weergeven
In dit voorbeeld ziet u de complexiteit van de parameter ExpandProperty.
De gegenereerde uitvoer is een matrix van [System.Int32]
exemplaren. De exemplaren voldoen aan de standaardopmaakregels van de uitvoerweergave. Dit geldt voor alle eigenschappen van Uitgevouwen. Als de uitvoerobjecten een specifieke standaardindeling hebben, is de uitgevouwen eigenschap mogelijk niet zichtbaar.
# Create a custom object to use for the Select-Object example.
$object = [pscustomobject]@{Name="CustomObject";Expand=@(1,2,3,4,5)}
# Use the ExpandProperty parameter to Expand the property.
$object | Select-Object -ExpandProperty Expand -Property Name
1
2
3
4
5
# The output did not contain the Name property, but it was added successfully.
# Use Get-Member to confirm the Name property was added and populated.
$object | Select-Object -ExpandProperty Expand -Property Name | Get-Member
TypeName: System.Int32
Name MemberType Definition
---- ---------- ----------
CompareTo Method int CompareTo(System.Object value), int CompareTo(int value), ...
Equals Method bool Equals(System.Object obj), bool Equals(int obj), bool IEq...
GetHashCode Method int GetHashCode()
GetType Method type GetType()
GetTypeCode Method System.TypeCode GetTypeCode(), System.TypeCode IConvertible.Ge...
ToBoolean Method bool IConvertible.ToBoolean(System.IFormatProvider provider)
ToByte Method byte IConvertible.ToByte(System.IFormatProvider provider)
ToChar Method char IConvertible.ToChar(System.IFormatProvider provider)
ToDateTime Method datetime IConvertible.ToDateTime(System.IFormatProvider provider)
ToDecimal Method decimal IConvertible.ToDecimal(System.IFormatProvider provider)
ToDouble Method double IConvertible.ToDouble(System.IFormatProvider provider)
ToInt16 Method int16 IConvertible.ToInt16(System.IFormatProvider provider)
ToInt32 Method int IConvertible.ToInt32(System.IFormatProvider provider)
ToInt64 Method long IConvertible.ToInt64(System.IFormatProvider provider)
ToSByte Method sbyte IConvertible.ToSByte(System.IFormatProvider provider)
ToSingle Method float IConvertible.ToSingle(System.IFormatProvider provider)
ToString Method string ToString(), string ToString(string format), string ToS...
ToType Method System.Object IConvertible.ToType(type conversionType, System...
ToUInt16 Method uint16 IConvertible.ToUInt16(System.IFormatProvider provider)
ToUInt32 Method uint32 IConvertible.ToUInt32(System.IFormatProvider provider)
ToUInt64 Method uint64 IConvertible.ToUInt64(System.IFormatProvider provider)
Name NoteProperty string Name=CustomObject
Voorbeeld 10: Aangepaste eigenschappen maken voor objecten
In het volgende voorbeeld ziet u hoe u Select-Object
gebruikt om een aangepaste eigenschap toe te voegen aan een object.
Wanneer u een eigenschapsnaam opgeeft die niet bestaat, maakt Select-Object
die eigenschap als een NoteProperty- voor elk object dat wordt doorgegeven.
$customObject = 1 | Select-Object -Property MyCustomProperty
$customObject.MyCustomProperty = "New Custom Property"
$customObject
MyCustomProperty
----------------
New Custom Property
Voorbeeld 11: Berekende eigenschappen maken voor elk InputObject
In dit voorbeeld ziet u hoe u Select-Object
gebruikt om berekende eigenschappen toe te voegen aan uw invoer. Door een ScriptBlock- door te geven aan de parameter eigenschap zorgt ervoor dat Select-Object
de expressie voor elk doorgegeven object evalueert en de resultaten toevoegt aan de uitvoer. In de ScriptBlock-kunt u de $_
variabele gebruiken om te verwijzen naar het huidige object in de pijplijn.
Standaard gebruikt Select-Object
de ScriptBlock tekenreeks als de naam van de eigenschap. Met behulp van een Hashtable-kunt u de uitvoer van uw ScriptBlock labelen als een aangepaste eigenschap die aan elk object is toegevoegd. U kunt meerdere berekende eigenschappen toevoegen aan elk object dat wordt doorgegeven aan Select-Object
.
# Create a calculated property called $_.StartTime.DayOfWeek
Get-Process | Select-Object -Property ProcessName,{$_.StartTime.DayOfWeek}
ProcessName $_.StartTime.DayOfWeek
---- ----------------------
alg Wednesday
ati2evxx Wednesday
ati2evxx Thursday
...
# Add a custom property to calculate the size in KiloBytes of each FileInfo
# object you pass in. Use the pipeline variable to divide each file's length by
# 1 KiloBytes
$size = @{label="Size(KB)";expression={$_.length/1KB}}
# Create an additional calculated property with the number of Days since the
# file was last accessed. You can also shorten the key names to be 'l', and 'e',
# or use Name instead of Label.
$days = @{l="Days";e={((Get-Date) - $_.LastAccessTime).Days}}
# You can also shorten the name of your label key to 'l' and your expression key
# to 'e'.
Get-ChildItem $PSHOME -File | Select-Object Name, $size, $days
Name Size(KB) Days
---- -------- ----
Certificate.format.ps1xml 12.5244140625 223
Diagnostics.Format.ps1xml 4.955078125 223
DotNetTypes.format.ps1xml 134.9833984375 223
Voorbeeld 12: Hashtable-sleutels selecteren zonder berekende eigenschappen te gebruiken
Vanaf PowerShell 6 ondersteunt Select-Object
het selecteren van de sleutels van hashtabel invoer als eigenschappen. In het volgende voorbeeld worden de weight
en name
sleutels voor een invoerhashtabel geselecteerd en wordt de uitvoer weergegeven.
@{ name = 'a' ; weight = 7 } | Select-Object -Property name, weight
name weight
---- ------
a 7
Parameters
-ExcludeProperty
Hiermee geeft u de eigenschappen op die door deze cmdlet worden uitgesloten van de bewerking. Jokertekens zijn toegestaan.
Vanaf PowerShell 6 is het niet meer nodig om de parameter Eigenschap op te nemen voor ExcludeProperty-.
Type: | String[] |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | True |
-ExpandProperty
Hiermee geeft u een eigenschap op die moet worden geselecteerd en wordt aangegeven dat er een poging moet worden gedaan om die eigenschap uit te vouwen. Als de pijplijn van het invoerobject niet de naam heeft, retourneert Select-Object
een fout.
- Als de opgegeven eigenschap een matrix is, wordt elke waarde van de matrix opgenomen in de uitvoer.
- Als de opgegeven eigenschap een object is, worden de eigenschappen van objecten uitgevouwen voor elke InputObject
In beide gevallen komt het Type van de uitgevouwen eigenschap overeen met het Typevan de uitgevouwen eigenschap.
Als de parameter eigenschap
Waarschuwing
Als er een foutbericht wordt weergegeven dat een eigenschap niet kan worden verwerkt omdat er al een eigenschap met die naam bestaat, kunt u het volgende overwegen. Houd er rekening mee dat wanneer u ExpandProperty-gebruikt, Select-Object
een bestaande eigenschap niet kan vervangen. Dit betekent:
- Als het uitgevouwen object een eigenschap van dezelfde naam heeft, retourneert de opdracht een fout.
- Als het geselecteerd-object een eigenschap van dezelfde naam heeft als de eigenschap van een uitgevouwen object, retourneert de opdracht een fout.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-First
Hiermee geeft u het aantal objecten dat moet worden geselecteerd vanaf het begin van een matrix met invoerobjecten.
Type: | Int32 |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Index
Hiermee selecteert u objecten uit een matrix op basis van hun indexwaarden. Voer de indexen in een door komma's gescheiden lijst in. Indexen in een matrix beginnen met 0, waarbij 0 de eerste waarde vertegenwoordigt en (n-1) de laatste waarde vertegenwoordigt.
Type: | Int32[] |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-InputObject
Hiermee geeft u objecten te verzenden naar de cmdlet via de pijplijn. Met deze parameter kunt u objecten doorsluizen naar Select-Object
.
Wanneer u objecten doorgeeft aan de parameter InputObject, in plaats van de pijplijn te gebruiken, behandelt Select-Object
het InputObject als één object, zelfs als de waarde een verzameling is. Het wordt aanbevolen om de pijplijn te gebruiken bij het doorgeven van verzamelingen aan Select-Object
.
Type: | PSObject |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-Last
Hiermee geeft u het aantal objecten op dat moet worden geselecteerd aan het einde van een matrix met invoerobjecten.
Type: | Int32 |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Property
Hiermee geeft u de eigenschappen die u wilt selecteren. Deze eigenschappen worden toegevoegd als NoteProperty leden aan de uitvoerobjecten. Jokertekens zijn toegestaan. Als het invoerobject niet de naam heeft van de eigenschap, wordt de waarde van de nieuwe NoteProperty- ingesteld op $null
.
De waarde van de parameter eigenschap kan een nieuwe berekende eigenschap zijn. Als u een berekende eigenschap wilt maken, gebruikt u een hash-tabel.
Geldige sleutels zijn:
- Naam (of label) -
<string>
- Expressie:
<string>
of<script block>
Zie about_Calculated_Propertiesvoor meer informatie.
Type: | Object[] |
Position: | 0 |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | True |
-Skip
Slaat het opgegeven aantal items over (selecteert niet). Standaard telt de parameter overslaan vanaf het begin van de verzameling objecten. Als de opdracht de parameter Last gebruikt, wordt deze geteld vanaf het einde van de verzameling.
In tegenstelling tot de parameter Index, die begint met tellen bij 0, begint de parameter Skip bij 1.
Type: | Int32 |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-SkipIndex
Hiermee worden de objecten uit een matrix overgeslagen (niet geselecteerd) op basis van hun indexwaarden. Voer de indexen in een door komma's gescheiden lijst in. Indexen in een matrix beginnen met 0, waarbij 0 de eerste waarde vertegenwoordigt en (n-1) de laatste waarde vertegenwoordigt.
Deze parameter is geïntroduceerd in Windows PowerShell 6.0.
Type: | Int32[] |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-SkipLast
Slaat het opgegeven aantal items aan het einde van de lijst of matrix over (selecteert niet). Werkt op dezelfde manier als het gebruik van Skip samen met parameter Last.
In tegenstelling tot de parameter Index, die begint met tellen bij 0, begint de parameter SkipLast bij 1.
Type: | Int32 |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Unique
Hiermee geeft u op dat als een subset van de invoerobjecten identieke eigenschappen en waarden heeft, slechts één lid van de subset moet worden geselecteerd.
Unieke selecteert waarden nadat andere filterparameters zijn toegepast.
Deze parameter is hoofdlettergevoelig. Als gevolg hiervan worden tekenreeksen die alleen verschillen in tekenbehuizing als uniek beschouwd.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
-Wait
Geeft aan dat de cmdlet optimalisatie uitschakelt. PowerShell voert opdrachten uit in de volgorde waarin ze worden weergegeven in de opdrachtpijplijn en kunnen alle objecten genereren. Als u standaard een Select-Object
opdracht opneemt met de First of Index parameters in een opdrachtpijplijn, stopt PowerShell de opdracht waarmee de objecten worden gegenereerd zodra het geselecteerde aantal objecten wordt gegenereerd.
Deze parameter is geïntroduceerd in Windows PowerShell 3.0.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | False |
Invoerwaarden
U kunt objecten doorsluisen naar deze cmdlet.
Uitvoerwaarden
Deze cmdlet retourneert de invoerobjecten met alleen de geselecteerde eigenschappen.
Notities
PowerShell bevat de volgende aliassen voor Select-Object
:
- Alle platforms:
select
De optimalisatiefunctie van Select-Object
is alleen beschikbaar voor opdrachten die objecten naar de pijplijn schrijven terwijl ze worden verwerkt. Het heeft geen effect op opdrachten die verwerkte objecten bufferen en ze als verzameling schrijven. Het direct schrijven van objecten is een aanbevolen procedure voor het ontwerpen van cmdlets. Zie Single Records schrijven naar de pijplijn in sterk aangemoedigde ontwikkelingsrichtlijnenvoor meer informatie.