Select-Object
Sélectionne des objets ou des propriétés d'objet.
Syntaxe
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>]
Description
L’applet Select-Object
de commande sélectionne les propriétés spécifiées d’un objet ou d’un ensemble d’objets. Elle peut également sélectionner des objets uniques, un nombre spécifié d'objets ou des objets à une position spécifiée dans un tableau.
Pour sélectionner des objets d’une collection, utilisez les paramètres First, Last, Unique, Skip et Index . Pour sélectionner des propriétés d’objet, utilisez le paramètre Property . Lorsque vous sélectionnez des propriétés, Select-Object
retourne de nouveaux objets qui ont uniquement les propriétés spécifiées.
À compter de Windows PowerShell 3.0, Select-Object
inclut une fonctionnalité d’optimisation qui empêche la création et le traitement d’objets qui ne sont pas utilisés.
Lorsque vous utilisez Select-Object
les paramètres First ou Index dans un pipeline de commandes, PowerShell arrête la commande qui génère les objets dès que le nombre d’objets sélectionné est atteint. Pour désactiver ce comportement d’optimisation, utilisez le paramètre Wait .
Exemples
Exemple 1 : Sélectionner des objets par propriété
Cet exemple crée des objets qui ont les propriétés Name, ID et WS (Working Set) des objets de processus.
Get-Process | Select-Object -Property ProcessName, Id, WS
Exemple 2 : Sélectionner des objets par propriété et mettre en forme les résultats
Cet exemple obtient des informations sur les modules utilisés par les processus sur l’ordinateur. Il utilise Get-Process
l’applet de commande pour obtenir le processus sur l’ordinateur.
Il utilise l’applet Select-Object
de commande pour générer un tableau d’instances [System.Diagnostics.ProcessModule]
tel qu’il est contenu dans la propriété Modules de chaque System.Diagnostics.Process
sortie d’instance par Get-Process
.
Le paramètre Property de l’applet Select-Object
de commande sélectionne les noms de processus. Cela ajoute une ProcessName
NoteProperty à chaque [System.Diagnostics.ProcessModule]
instance et la remplit avec la valeur de la propriété ProcessName du processus actuel.
Enfin, Format-List
l’applet de commande est utilisée pour afficher le nom et les modules de chaque processus dans une liste.
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
...
Exemple 3 : Sélectionner des processus à l’aide de la mémoire la plus élevée
Cet exemple obtient les cinq processus qui utilisent le plus de mémoire. L’applet Get-Process
de commande obtient les processus sur l’ordinateur. L’applet Sort-Object
de commande trie les processus en fonction de l’utilisation de la mémoire (jeu de travail), et l’applet Select-Object
de commande sélectionne uniquement les cinq derniers membres du tableau d’objets résultant.
Le paramètre Wait n’est pas obligatoire dans les commandes qui incluent l’applet Sort-Object
de commande, car Sort-Object
traite tous les objets, puis retourne une collection. L’optimisation Select-Object
est disponible uniquement pour les commandes qui retournent des objets individuellement au fur et à mesure qu’ils sont traités.
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
Exemple 4 : Sélectionner des caractères uniques à partir d’un tableau
Cet exemple utilise le paramètre Unique pour Select-Object
obtenir des caractères uniques à partir d’un tableau de caractères.
"a","b","c","a","a","a" | Select-Object -Unique
a
b
c
Exemple 5 : Utilisation de « -Unique » avec d’autres paramètres
Les valeurs des filtres de paramètres uniques après l’application d’autres Select-Object
paramètres. Par exemple, si vous utilisez le paramètre First pour sélectionner le premier nombre d’éléments d’un tableau, Unique est appliqué uniquement aux valeurs sélectionnées et non à l’ensemble du tableau.
"a","a","b","c" | Select-Object -First 2 -Unique
a
Dans cet exemple, first sélectionne "a","a"
les 2 premiers éléments du tableau. Unique est appliqué et "a","a"
retourne a
comme valeur unique.
Exemple 6 : Sélectionner les événements les plus récents et les plus anciens dans le journal des événements
Cet exemple obtient les premiers événements (les plus récents) et les derniers (les plus anciens) dans le journal des événements Windows PowerShell.
Get-EventLog
obtient tous les événements dans le journal Windows PowerShell et les enregistre dans la $a
variable.
Ensuite, $a
est redirigé vers l’applet Select-Object
de commande. La Select-Object
commande utilise le paramètre Index pour sélectionner des événements dans le tableau d’événements dans la $a
variable. L'index du premier événement est 0. L’index du dernier événement est le nombre d’éléments en $a
moins 1.
$a = Get-EventLog -LogName "Windows PowerShell"
$a | Select-Object -Index 0, ($A.count - 1)
Exemple 7 : Sélectionner tout mais le premier objet
Cet exemple crée une nouvelle session PSSession sur chacun des ordinateurs répertoriés dans les fichiers Servers.txt, à l’exception de la première.
Select-Object
sélectionne tout mais le premier ordinateur dans une liste de noms d’ordinateurs. La liste résultante des ordinateurs est définie comme valeur du paramètre ComputerName de l’applet New-PSSession
de commande.
New-PSSession -ComputerName (Get-Content Servers.txt | Select-Object -Skip 1)
Exemple 8 : Renommer des fichiers et sélectionner plusieurs pour passer en revue
Cet exemple ajoute un suffixe « -ro » aux noms de base des fichiers texte qui ont l’attribut en lecture seule, puis affiche les cinq premiers fichiers afin que l’utilisateur puisse voir un exemple de l’effet.
Get-ChildItem
utilise le paramètre dynamique ReadOnly pour obtenir des fichiers en lecture seule. Les fichiers résultants sont redirigés vers l’applet Rename-Item
de commande, qui renomme le fichier. Il utilise le paramètre PassThru pour Rename-Item
envoyer les fichiers renommés à l’applet Select-Object
de commande, qui sélectionne les 5 premiers pour l’affichage.
Le paramètre Wait d’empêche Select-Object
PowerShell d’arrêter l’applet Get-ChildItem
de commande une fois les cinq premiers fichiers texte en lecture seule. Sans ce paramètre, seuls les cinq premiers fichiers en lecture seule seraient renommés.
Get-ChildItem *.txt -ReadOnly |
Rename-Item -NewName {$_.BaseName + "-ro.txt"} -PassThru |
Select-Object -First 5 -Wait
Exemple 9 : Afficher les complexités du paramètre -ExpandProperty
Cet exemple montre les complexités du paramètre ExpandProperty .
Notez que la sortie générée était un tableau d’instances [System.Int32]
. Les instances sont conformes aux règles de mise en forme standard de la vue sortie. Cela est vrai pour toutes les propriétés développées . Si les objets générés ont un format standard spécifique, la propriété développée peut ne pas être visible.
# 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
Exemple 10 : Créer des propriétés personnalisées sur des objets
L’exemple suivant montre comment ajouter Select-Object
une propriété personnalisée à n’importe quel objet.
Lorsque vous spécifiez un nom de propriété qui n’existe pas, Select-Object
crée cette propriété en tant que NoteProperty sur chaque objet passé.
$customObject = 1 | Select-Object -Property MyCustomProperty
$customObject.MyCustomProperty = "New Custom Property"
$customObject
MyCustomProperty
----------------
New Custom Property
Exemple 11 : Créer des propriétés calculées pour chaque InputObject
Cet exemple montre comment ajouter Select-Object
des propriétés calculées à votre entrée. Le passage d’un ScriptBlock au paramètre Property entraîne Select-Object
l’évaluation de l’expression sur chaque objet passé et l’ajout des résultats à la sortie. Dans ScriptBlock, vous pouvez utiliser la $_
variable pour référencer l’objet actuel dans le pipeline.
Par défaut, Select-Object
utilise la chaîne ScriptBlock comme nom de la propriété. À l’aide d’une table de hachage, vous pouvez étiqueter la sortie de votre ScriptBlock en tant que propriété personnalisée ajoutée à chaque objet. Vous pouvez ajouter plusieurs propriétés calculées à chaque objet passé à 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
Exemple 12 : Sélection des clés d’une table de hachage avec des propriétés calculées
Cet exemple montre comment afficher Select-Object
les paires clé-valeur d’un objet de table de hachage avec des propriétés calculées. Chaque table de hachage de propriété calculée spécifie l’étiquette de la nouvelle propriété comme nom d’affichage de la clé et une expression qui récupère la valeur de cette clé.
@{ name = 'a' ; weight = 7 } | Select-Object -Property @(
@{ label = 'Name' ; expression = { $_.name } }
@{ label = 'Weight' ; expression = { $_.weight } }
)
Name Weight
---- ------
a 7
Exemple 13 - ExpandProperty modifie l’objet d’origine
Cet exemple illustre l’effet secondaire de l’utilisation du paramètre ExpandProperty . Lorsque vous utilisez ExpandProperty, Select-Object
ajoute les propriétés sélectionnées à l’objet d’origine en tant que membres NoteProperty .
PS> $object = [PSCustomObject]@{
name = 'USA'
children = [PSCustomObject]@{
name = 'Southwest'
}
}
PS> $object
name children
---- --------
USA @{name=Southwest}
# Use the ExpandProperty parameter to expand the children property
PS> $object | Select-Object @{n="country"; e={$_.name}} -ExpandProperty children
name country
---- -------
Southwest USA
# The original object has been altered
PS> $object
name children
---- --------
USA @{name=Southwest; country=USA}
Comme vous pouvez le voir, la propriété country a été ajoutée à l’objet enfants après l’utilisation du paramètre ExpandProperty .
Exemple 14 : Créer un objet avec des propriétés développées sans modifier l’objet d’entrée
Vous pouvez éviter l’effet secondaire de l’utilisation du paramètre ExpandProperty en créant un objet et en copiant les propriétés à partir de l’objet d’entrée.
PS> $object = [PSCustomObject]@{
name = 'USA'
children = [PSCustomObject]@{
name = 'Southwest'
}
}
PS> $object
name children
---- --------
USA @{name=Southwest}
# Create a new object with selected properties
PS> $newobject = [PSCustomObject]@{
country = $object.name
children = $object.children
}
PS> $newobject
country children
------- --------
USA @{name=Southwest}
# $object remains unchanged
PS> $object
name children
---- --------
USA @{name=Southwest}
Paramètres
-ExcludeProperty
Spécifie les propriétés que cette applet de commande exclut de l’opération. Les caractères génériques sont autorisés. Ce paramètre est effectif uniquement lorsque la commande inclut également le paramètre Property .
Type: | String[] |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | True |
-ExpandProperty
Spécifie une propriété à sélectionner et indique qu'une tentative doit être effectuée pour développer cette propriété. Si le pipeline d’objet d’entrée n’a pas la propriété nommée, Select-Object
retourne une erreur.
- Si la propriété spécifiée est un tableau, chaque valeur du tableau est incluse dans la sortie.
- Si la propriété spécifiée est un objet, les propriétés d’objets sont développées pour chaque InputObject
Dans les deux cas, le type des objets de sortie correspond au type de la propriété développée.
Remarque
Il existe un effet secondaire lors de l’utilisation de ExpandProperty. Ajoute Select-Object
les propriétés sélectionnées à l’objet d’origine en tant que membres NoteProperty .
Si le paramètre Property est spécifié, Select-Object
tente d’ajouter chaque propriété sélectionnée en tant que NoteProperty à chaque objet généré.
Avertissement
Si vous recevez une erreur indiquant qu’une propriété ne peut pas être traitée, car une propriété portant ce nom existe déjà, tenez compte des éléments suivants. Notez que lors de l’utilisation de ExpandProperty, Select-Object
ne peut pas remplacer une propriété existante. En d’autres termes :
- Si l’objet développé a une propriété du même nom, la commande retourne une erreur.
- Si l’objet Selected a une propriété du même nom que la propriété d’un objet développé , la commande renvoie une erreur.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-First
Spécifie le nombre d'objets à sélectionner à partir du début d'un tableau d'objets d'entrée.
Type: | Int32 |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Index
Sélectionne des objets dans un tableau en fonction de leurs valeurs d'index. Entrez les index dans une liste séparée par des virgules. Les index d'un tableau commencent à 0, où 0 représente la première valeur et (n-1) représente la dernière valeur.
Type: | Int32[] |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-InputObject
Spécifie des objets à envoyer à l'applet de commande via le pipeline. Ce paramètre vous permet de diriger des objets vers Select-Object
.
Lorsque vous passez des objets au paramètre InputObject , au lieu d’utiliser le pipeline, Select-Object
traite InputObject comme un objet unique, même si la valeur est une collection. Il est recommandé d’utiliser le pipeline lors du passage de regroupements à Select-Object
.
Type: | PSObject |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-Last
Spécifie le nombre d'objets à sélectionner à partir de la fin d'un tableau d'objets d'entrée.
Type: | Int32 |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Property
Spécifie les propriétés à sélectionner. Ces propriétés sont ajoutées en tant que membres NoteProperty aux objets de sortie. Les caractères génériques sont autorisés. Si l’objet d’entrée n’a pas la propriété nommée, la valeur du nouveau NoteProperty est définie $null
sur .
La valeur du paramètre Property peut être une nouvelle propriété calculée. Pour créer une propriété calculée, utilisez une table de hachage.
Les clés valides sont les suivantes :
- Nom (ou étiquette) -
<string>
- Expression -
<string>
ou<script block>
Pour plus d’informations, consultez about_Calculated_Properties.
Type: | Object[] |
Position: | 0 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | True |
-Skip
Ignore (ne sélectionne pas) le nombre spécifié d’éléments. Par défaut, le paramètre Skip compte à partir du début de la collection d’objets. Si la commande utilise le paramètre Last , elle compte à partir de la fin de la collection.
Contrairement au paramètre Index , qui commence à compter à 0, le paramètre Skip commence à 1.
Type: | Int32 |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-SkipLast
Ignore (ne sélectionne pas) le nombre spécifié d’éléments à partir de la fin de la liste ou du tableau. Fonctionne de la même façon que l’utilisation de Skip avec le paramètre Last.
Contrairement au paramètre Index , qui commence à compter à 0, le paramètre SkipLast commence à 1.
Type: | Int32 |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Unique
Spécifie que si un sous-ensemble des objets d’entrée a des propriétés et des valeurs identiques, seul un seul membre du sous-ensemble doit être sélectionné.
Unique sélectionne les valeurs après l’application d’autres paramètres de filtrage.
Ce paramètre respecte la casse. Par conséquent, les chaînes qui diffèrent uniquement par la casse sont considérées comme uniques.
Type: | SwitchParameter |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Wait
Indique que l’applet de commande désactive l’optimisation. PowerShell exécute des commandes dans l’ordre dans lequel elles apparaissent dans le pipeline de commandes et leur permet de générer tous les objets. Par défaut, si vous incluez une Select-Object
commande avec les paramètres First ou Index dans un pipeline de commandes, PowerShell arrête la commande qui génère les objets dès que le nombre d’objets sélectionné est généré.
Ce paramètre a été introduit dans Windows PowerShell 3.0.
Type: | SwitchParameter |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
Entrées
Vous pouvez diriger des objets vers cette applet de commande.
Sorties
Cette applet de commande retourne les objets d’entrée avec uniquement les propriétés sélectionnées.
Notes
Windows PowerShell inclut les alias suivants pour Select-Object
:
select
La fonctionnalité d’optimisation est Select-Object
disponible uniquement pour les commandes qui écrivent des objets dans le pipeline au fur et à mesure qu’ils sont traités. Elle n'a pas d'effet sur les commandes qui placent les objets traités dans une mémoire tampon et les écrivent sous forme de collection. Écrire immédiatement les objets est une pratique recommandée dans la conception des applets de commande. Pour plus d’informations, consultez Écrire des enregistrements uniques dans le pipeline dans des instructions de développement fortement encouragées.