Partager via


À propos des membres intrinsèques

Description courte

Fournit des informations sur les membres intrinsèques de PowerShell disponibles pour tous les objets PowerShell.

Description détaillée

Lorsque des objets sont créés, PowerShell ajoute certaines propriétés et méthodes « masquées » à chaque objet. Ces propriétés et méthodes sont appelées membres intrinsèques. Ces membres intrinsèques sont normalement masqués de la vue. Ces membres masqués sont visibles à l’aide du paramètre Force de Get-Member.

Vues d’objets

Les membres intrinsèques incluent un ensemble de propriétés MemberSet qui représentent une vue de l’objet. Pour plus d’informations sur les propriétés MemberSet , consultez PSMemberSet.

Chaque objet PowerShell inclut les propriétés suivantes.

  • psbase

    MemberSet psbase contient les membres de l’objet de base sans extension ni adaptation. Selon le type d’objet, il s’agit d’une instance .NET encapsulée par une [psobject] instance ou, s’il n’y a pas de wrapper, il s’agit de l’objet d’entrée lui-même.

  • psadapted

    Le psadapted MemberSet affiche l’objet de base ainsi que les membres adaptés, le cas échéant. Les membres adaptés sont ajoutés par le système de type étendu (ETS).

  • psextended

    L’ensemble psextended de membres affiche uniquement les membres ajoutés par les fichiers Types.ps1xml et l’applet de commande Add-Member. Tout objet peut être étendu au moment de l’exécution à l’aide de l’applet de Add-Member commande.

  • psobject

    psobject MemberSet est une source riche de réflexion pour tous les objets qui incluent des méthodes, des propriétés et d’autres informations sur l’objet.

Exemples

Pour cet exemple, $hash est une table de hachage contenant des informations sur un utilisateur. Le paramètre Force de Get-Member nous montre les membres intrinsèques de l’objet.

$hash = @{
    Age  = 33
    Name = 'Bob'
}

$hash | Get-Member -Force -MemberType MemberSet, CodeProperty
   TypeName: System.Collections.Hashtable

Name        MemberType   Definition
----        ----------   ----------
pstypenames CodeProperty System.Collections.ObjectModel.Collection`1[[System.String, System.Private.CoreLib, Version=7…
psadapted   MemberSet    psadapted {Item, IsReadOnly, IsFixedSize, IsSynchronized, Keys, Values, SyncRoot, Count, Add,…
psbase      MemberSet    psbase {Item, IsReadOnly, IsFixedSize, IsSynchronized, Keys, Values, SyncRoot, Count, Add, Cl…
psextended  MemberSet    psextended {}
psobject    MemberSet    psobject {Members, Properties, Methods, ImmediateBaseObject, BaseObject, TypeNames, get_Membe…

L’utilisation psobject est similaire à l’utilisation Get-Member, mais offre plus de flexibilité. Par exemple, vous pouvez énumérer les propriétés d’un objet et leurs valeurs.

$hash.psobject.Properties | Select-Object Name, MemberType, Value
Name           MemberType                    Value
----           ----------                    -----
IsReadOnly       Property                    False
IsFixedSize      Property                    False
IsSynchronized   Property                    False
Keys             Property              {Age, Name}
Values           Property                {33, Bob}
SyncRoot         Property {[Age, 33], [Name, Bob]}
Count            Property                        2

Comparez cela à l’objet créé en convertissant la table de hachage en psCustomObject.

$user = [pscustomobject]$hash
$user.psobject.Properties | Select-Object Name, MemberType, Value
Name   MemberType Value
----   ---------- -----
Age  NoteProperty    33
Name NoteProperty   Bob

Notez que les clés de la table de hachage ont été converties en propriétés dans PSCustomObject. Les nouvelles propriétés font désormais partie du psextendedMemberSet.

$user | Get-Member -Force -MemberType MemberSet, CodeProperty
   TypeName: System.Management.Automation.PSCustomObject

Name        MemberType   Definition
----        ----------   ----------
pstypenames CodeProperty System.Collections.ObjectModel.Collection`1[[System.String, System.Private.CoreLib, Version=7…
psadapted   MemberSet    psadapted {ToString, GetType, Equals, GetHashCode}
psbase      MemberSet    psbase {ToString, GetType, Equals, GetHashCode}
psextended  MemberSet    psextended {Age, Name}
psobject    MemberSet    psobject {Members, Properties, Methods, ImmediateBaseObject, BaseObject, TypeNames, get_Membe…

Informations de type

CodeProperty pstypenames répertorie la hiérarchie de type d’objet dans l’ordre d’héritage. Par exemple :

$file = Get-Item C:\temp\test.txt
$file.pstypenames
System.IO.FileInfo
System.IO.FileSystemInfo
System.MarshalByRefObject
System.Object

La sortie commence par le type d’objet le plus spécifique, System.IO.FileInfoet continue jusqu’au type le plus générique, System.Object.

Méthodes

PowerShell ajoute deux méthodes masquées à tous les objets PowerShell. Ces méthodes ne sont pas visibles à l’aide de la commande ou de la Get-Member -Force saisie semi-automatique de tabulation.

ForEach() et Where()

Les ForEach() méthodes et Where() les méthodes sont disponibles pour tous les objets PowerShell. Toutefois, ils sont les plus utiles lors de l’utilisation de collections. Pour plus d’informations sur l’utilisation de ces méthodes, consultez about_Arrays.

Propriétés

Les propriétés Count et Length sont disponibles pour tous les objets PowerShell, pas seulement pour les collections. Ils sont similaires les uns aux autres, mais peuvent fonctionner différemment selon le type de données. Par exemple, la longueur d’une chaîne est le nombre de caractères dans la chaîne. La propriété Count est le nombre d’instances de l’objet.

PS> $str = 'string'
PS> $str.Length
6
PS> $str.Count
1

Pour plus d’informations sur ces propriétés, consultez about_Properties.

Types scalaires d’indexation de tableau

Lorsqu’un objet n’est pas une collection indexée, l’utilisation de l’opérateur d’index pour accéder au premier élément retourne l’objet lui-même. Valeurs d’index au-delà du premier élément retourné $null.

PS> (2)[0]
2
PS> (2)[-1]
2
PS> (2)[1] -eq $null
True
PS> (2)[0,0] -eq $null
True

Pour plus d’informations, consultez about_Operators.

Méthode New() pour les types

À compter de PowerShell 5.0, PowerShell ajoute une méthode statique New() pour tous les types .NET. Les exemples suivants produisent le même résultat.

$expression = New-Object -TypeName regex -ArgumentList 'pattern'
$expression = [regex]::new('pattern')

L’utilisation de la new() méthode fonctionne mieux que l’utilisation New-Object.

Pour plus d’informations, consultez about_Classes.