Freigeben über


Get-Member

Ruft die Eigenschaften und Methoden der Objekte ab.

Syntax

Get-Member
   [-InputObject <PSObject>]
   [[-Name] <String[]>]
   [-MemberType <PSMemberTypes>]
   [-View <PSMemberViewTypes>]
   [-Static]
   [-Force]
   [<CommonParameters>]

Beschreibung

Das Get-Member Cmdlet ruft die Member, die Eigenschaften und Methoden von Objekten ab.

Verwenden Sie zum Angeben des Objekts den InputObject-Parameter oder das Pipen eines Objekts an Get-Member. Verwenden Sie zum Abrufen von Informationen zu statischen Membern die Member der Klasse und nicht der Instanz den Static-Parameter . Verwenden Sie den MemberType-Parameter, um nur bestimmte Typen von Membern abzurufen, z. B. NoteProperties.

Get-Member gibt eine Liste von Elementen zurück, die alphabetisch sortiert sind. Methoden werden zuerst aufgelistet, gefolgt von den Eigenschaften.

Beispiele

Beispiel 1: Abrufen der Member von Prozessobjekten

Mit diesem Befehl werden die Eigenschaften und Methoden der vom Get-Service Cmdlet generierten Dienstobjekte angezeigt.

Da der Get-Member Teil des Befehls keine Parameter enthält, verwendet er Standardwerte für die Parameter. Get-Member Standardmäßig werden keine statischen oder systeminternen Member abgerufen.

Get-Service | Get-Member

TypeName: System.Service.ServiceController#StartupType

Name                      MemberType    Definition
----                      ----------    ----------
Name                      AliasProperty Name = ServiceName
RequiredServices          AliasProperty RequiredServices = ServicesDependedOn
Disposed                  Event         System.EventHandler Disposed(System.Object, System.EventArgs)
Close                     Method        void Close()
Continue                  Method        void Continue()
Dispose                   Method        void Dispose(), void IDisposable.Dispose()
Equals                    Method        bool Equals(System.Object obj)
ExecuteCommand            Method        void ExecuteCommand(int command)
GetHashCode               Method        int GetHashCode()
GetLifetimeService        Method        System.Object GetLifetimeService()
GetType                   Method        type GetType()
InitializeLifetimeService Method        System.Object InitializeLifetimeService()
Pause                     Method        void Pause()
Refresh                   Method        void Refresh()
Start                     Method        void Start(), void Start(string[] args)
Stop                      Method        void Stop()
WaitForStatus             Method        void WaitForStatus(System.ServiceProcess.ServiceControllerSt...
BinaryPathName            Property      System.String {get;set;}
CanPauseAndContinue       Property      bool CanPauseAndContinue {get;}
CanShutdown               Property      bool CanShutdown {get;}
CanStop                   Property      bool CanStop {get;}
Container                 Property      System.ComponentModel.IContainer Container {get;}
DelayedAutoStart          Property      System.Boolean {get;set;}
DependentServices         Property      System.ServiceProcess.ServiceController[] DependentServices {get;}
Description               Property      System.String {get;set;}
DisplayName               Property      string DisplayName {get;set;}
MachineName               Property      string MachineName {get;set;}
ServiceHandle             Property      System.Runtime.InteropServices.SafeHandle ServiceHandle {get;}
ServiceName               Property      string ServiceName {get;set;}
ServicesDependedOn        Property      System.ServiceProcess.ServiceController[] ServicesDependedOn {get;}
ServiceType               Property      System.ServiceProcess.ServiceType ServiceType {get;}
Site                      Property      System.ComponentModel.ISite Site {get;set;}
StartType                 Property      System.ServiceProcess.ServiceStartMode StartType {get;}
StartupType               Property      Microsoft.PowerShell.Commands.ServiceStartupType {get;set;}
Status                    Property      System.ServiceProcess.ServiceControllerStatus Status {get;}
UserName                  Property      System.String {get;set;}
ToString                  ScriptMethod  System.Object ToString();

Beispiel 2: Abrufen von Mitgliedern von Dienstobjekten

In diesem Beispiel werden alle Elemente (Eigenschaften und Methoden) von Dienstobjekten abgerufen, die Get-Service vom Cmdlet abgerufen werden, einschließlich der systeminternen Member, z . B. PSBase, PSObject und der methoden get_ und set_ .

Get-Service | Get-Member -Force
(Get-Service Schedule).PSBase

Der Get-Member Befehl verwendet den Parameter Force , um die systeminternen Member und vom Compiler generierten Member der Objekte zur Anzeige hinzuzufügen. Sie können diese Eigenschaften und Methoden auf die gleiche Weise verwenden wie eine angepasste Methode des Objekts. Der zweite Befehl zeigt, wie der Wert der PSBase-Eigenschaft des Zeitplandiensts angezeigt wird. Weitere Informationen zu systeminternen Elementen finden Sie unter about_Intrinsic_Members

Beispiel 3: Abrufen erweiterter Elemente von Dienstobjekten

Dieses Beispiel ruft die Methoden und Eigenschaften von Dienstobjekten ab, die mithilfe einer Types.ps1xml Datei oder des Add-Member Cmdlets erweitert wurden.

Get-Service | Get-Member -View Extended

TypeName: System.Service.ServiceController#StartupType

Name             MemberType    Definition
----             ----------    ----------
Name             AliasProperty Name = ServiceName
RequiredServices AliasProperty RequiredServices = ServicesDependedOn
ToString         ScriptMethod  System.Object ToString();

Der Get-Member Befehl verwendet den Parameter "View" , um nur die erweiterten Member der Dienstobjekte abzurufen. In diesem Fall ist das erweiterte Element die Name-Eigenschaft , bei der es sich um eine Aliaseigenschaft der ServiceName-Eigenschaft handelt.

Beispiel 4: Abrufen von Skripteigenschaften von Ereignisprotokollobjekten

In diesem Beispiel werden die Skripteigenschaften von Ereignisprotokollobjekten im Systemprotokoll Ereignisanzeige.

Get-WinEvent -LogName System -MaxEvents 1 | Get-Member -MemberType NoteProperty

TypeName: System.Diagnostics.Eventing.Reader.EventLogRecord

Name    MemberType   Definition
----    ----------   ----------
Message NoteProperty string Message=The machine-default permission settings do not grant Local ...

Der MemberType-Parameter ruft nur Objekte mit einem Wert NoteProperty für die MemberType-Eigenschaft ab.

Der Befehl gibt die Message-Eigenschaft des EventLogRecord -Objekts zurück.

Beispiel 5: Abrufen von Objekten mit einer angegebenen Eigenschaft

In diesem Beispiel werden Objekte abgerufen, die über eine MachineName-Eigenschaft in der Ausgabe aus einer Liste von Cmdlets verfügen.

Die $list Variable enthält eine Liste der zu bewertenden Cmdlets. Die foreach Anweisung ruft jeden Befehl auf und sendet die Ergebnisse an Get-Member. Der Name-Parameter beschränkt die Ergebnisse auf Get-Member Member mit dem Namen MachineName.

$list = "Get-Process", "Get-Service", "Get-Culture", "Get-PSDrive", "Get-ExecutionPolicy"
foreach ($cmdlet in $list) {& $cmdlet | Get-Member -Name MachineName}

TypeName: System.Diagnostics.Process

Name        MemberType Definition
----        ---------- ----------
MachineName Property   string MachineName {get;}

   TypeName: System.Service.ServiceController#StartupType

Name        MemberType Definition
----        ---------- ----------
MachineName Property   string MachineName {get;set;}

Die Ergebnisse zeigen, dass nur Prozessobjekte und Dienstobjekte eine MachineName-Eigenschaft aufweisen.

Beispiel 6: Abrufen von Mitgliedern für ein Array

In diesem Beispiel wird veranschaulicht, wie Die Member eines Arrays von Objekten gefunden werden. Wenn Sie Objekte Get-Memberweiterleiten und an diese arrays übergeben, gibt das Cmdlet eine Memberliste für jeden eindeutigen Objekttyp im Array zurück. Wenn Sie das Array mithilfe des InputObject-Parameters übergeben, wird das Array als einzelnes Objekt behandelt.

$array = @(1,'hello')
$array | Get-Member

TypeName: System.Int32

Name        MemberType Definition
----        ---------- ----------
CompareTo   Method     int CompareTo(System.Object value), int CompareTo(int value), int ICompar...
Equals      Method     bool Equals(System.Object obj), bool Equals(int obj), bool IEquatable[int...
GetHashCode Method     int GetHashCode()
GetType     Method     type GetType()
GetTypeCode Method     System.TypeCode GetTypeCode(), System.TypeCode IConvertible.GetTypeCode()
ToBoolean   Method     bool IConvertible.ToBoolean(System.IFormatProvider provider)
ToByte      Method     byte IConvertible.ToByte(System.IFormatProvider provider)
...

   TypeName: System.String

Name                 MemberType            Definition
----                 ----------            ----------
Clone                Method                System.Object Clone(), System.Object ICloneable.Clone()
CompareTo            Method                int CompareTo(System.Object value), int CompareTo(str...
Contains             Method                bool Contains(string value), bool Contains(string val...
CopyTo               Method                void CopyTo(int sourceIndex, char[] destination, int ...
EndsWith             Method                bool EndsWith(string value), bool EndsWith(string val...
EnumerateRunes       Method                System.Text.StringRuneEnumerator EnumerateRunes()
Equals               Method                bool Equals(System.Object obj), bool Equals(string va...
GetEnumerator        Method                System.CharEnumerator GetEnumerator(), System.Collect...
GetHashCode          Method                int GetHashCode(), int GetHashCode(System.StringCompa...
...

Get-Member -InputObject $array

TypeName: System.Object[]

Name           MemberType            Definition
----           ----------            ----------
Add            Method                int IList.Add(System.Object value)
Address        Method                System.Object&, System.Private.CoreLib, Version=4.0.0.0, Cu...
Clear          Method                void IList.Clear()
Clone          Method                System.Object Clone(), System.Object ICloneable.Clone()
CompareTo      Method                int IStructuralComparable.CompareTo(System.Object other, Sy...
...

Die $array Variable enthält ein Int32-Objekt und ein Zeichenfolgenobjekt , wie beim Übergeben des Arrays zu Get-Membersehen ist. Wenn $array mithilfe des InputObject-Parameters Get-Member übergeben wird, werden die Elemente des Object[]-Typs zurückgegeben.

Beispiel 7: Bestimmen, welche Objekteigenschaften Sie festlegen können

Dieses Beispiel zeigt, wie Sie bestimmen können, welche Eigenschaften eines Objekts geändert werden können.

$File = Get-Item c:\test\textFile.txt
$File.PSObject.Properties | Where-Object isSettable | Select-Object -Property Name

Name
----
PSPath
PSParentPath
PSChildName
PSDrive
PSProvider
PSIsContainer
IsReadOnly
CreationTime
CreationTimeUtc
LastAccessTime
LastAccessTimeUtc
LastWriteTime
LastWriteTimeUtc
Attributes

Beispiel 8: Auflisten der Eigenschaften eines Objekts in der Reihenfolge, in der sie erstellt wurden

In diesem Beispiel wird ein neues PSObject erstellt und dieser Eigenschaften hinzugefügt. Get-Member listet die Eigenschaften in alphabetischer Reihenfolge auf. Um die Eigenschaften in der Reihenfolge anzuzeigen, in der sie dem Objekt hinzugefügt wurden, müssen Sie das systeminterne PSObject-Element verwenden.

$Asset = New-Object -TypeName PSObject
$d = [ordered]@{Name="Server30";System="Server Core";PSVersion="4.0"}
$Asset | Add-Member -NotePropertyMembers $d -TypeName Asset
$Asset.PSObject.Properties | Select-Object Name, Value

Name      Value
----      -----
Name      Server30
System    Server Core
PSVersion 4.0

Parameter

-Force

Fügt die systeminternen Member und die vom Compiler generierten get_ und set_ Methoden zur Anzeige hinzu. In der folgenden Liste werden die Eigenschaften beschrieben, die beim Verwenden des Force-Parameters hinzugefügt werden:

  • PSBase: Die ursprünglichen Eigenschaften des .NET-Objekts ohne Erweiterung oder Anpassung. Dies sind die Eigenschaften, die für die Objektklasse definiert sind.
  • PSAdapted: Die eigenschaften und Methoden, die im erweiterten PowerShell-Typsystem definiert sind.
  • PSExtended: Die Eigenschaften und Methoden, die in den Types.ps1xml Dateien oder mithilfe des Add-Member Cmdlets hinzugefügt wurden.
  • PSObject: Der Adapter, der das Basisobjekt in ein PowerShell-PSObject-Objekt konvertiert.
  • PSTypeNames: Eine Liste von Objekttypen, die das Objekt beschreiben, in der Reihenfolge der Spezifität. Beim Formatieren des Objekts sucht PowerShell nach den Typen in den Format.ps1xml Dateien im PowerShell-Installationsverzeichnis ($PSHOME). Dabei wird die Formatierungsdefinition für den ersten gefundenen Typ verwendet.

Ruft diese Eigenschaften standardmäßig Get-Member in allen Ansichten mit Ausnahme von "Base " und "Angepasst" ab, zeigt sie jedoch nicht an.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Gibt das Objekt an, dessen Member abgerufen werden.

Die Verwendung des InputObject-Parameters entspricht nicht dem Anfügen eines Objekts an Get-Member. Es gibt folgende Unterschiede:

  • Wenn Sie eine Auflistung von Objekten an Get-MemberGet-Member , ruft die Elemente der einzelnen Objekte in der Auflistung ab, z. B. die Eigenschaften jeder Zeichenfolge in einem Array von Zeichenfolgen.
  • Wenn Sie InputObject verwenden, um eine Auflistung von Objekten zu übermitteln, Get-Member ruft die Elemente der Auflistung ab, z. B. die Eigenschaften des Arrays in einem Array von Zeichenfolgen.
Typ:PSObject
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-MemberType

Gibt den Membertyp an, den dieses Cmdlet abruft. Der Standardwert ist All.

Zulässige Werte für diesen Parameter:

  • AliasProperty
  • CodeProperty
  • Property
  • NoteProperty
  • ScriptProperty
  • Properties
  • PropertySet
  • Method
  • CodeMethod
  • ScriptMethod
  • Methods
  • ParameterizedProperty
  • MemberSet
  • Event
  • Dynamic
  • All

Diese Werte werden als flagbasierte Enumeration definiert. Sie können mehrere Werte kombinieren, um mehrere Flags mithilfe dieses Parameters festzulegen. Die Werte können als Array von Werten oder als kommagetrennte Zeichenfolge dieser Werte an den MemberType-Parameter übergeben werden. Das Cmdlet kombiniert die Werte mithilfe eines Binary-OR-Vorgangs. Das Übergeben von Werten als Array ist die einfachste Option und ermöglicht ihnen auch die Verwendung des Tabstopps für die Werte.

Informationen zu diesen Werten finden Sie unter PSMemberTypes-Aufzählung.

Nicht alle Objekte verfügen über jeden Membertyp. Wenn Sie einen Elementtyp angeben, über den das Objekt nicht verfügt, gibt PowerShell einen NULL-Wert zurück. Verwenden Sie den View-Parameter , um verwandte Typen von Mitgliedern abzurufen, z. B. alle erweiterten Member. Wenn Sie den MemberType-Parameter mit den Parametern "Static " oder "View " verwenden, werden die Elemente abgerufen, Get-Member die zu beiden Sätzen gehören.

Typ:PSMemberTypes
Aliase:Type
Zulässige Werte:AliasProperty, CodeProperty, Property, NoteProperty, ScriptProperty, Properties, PropertySet, Method, CodeMethod, ScriptMethod, Methods, ParameterizedProperty, MemberSet, Event, Dynamic, All
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt die Namen von mindestens einer Eigenschaft oder Methode des Objekts an. Get-Member ruft nur die angegebenen Eigenschaften und Methoden ab.

Wenn Sie den Parameter "Name" mit dem Parameter "MemberType", "View" oder "Static " verwenden, ruft nur die Member ab, Get-Member die die Kriterien aller Parameter erfüllen.

Um ein statisches Element anhand des Namens abzurufen, verwenden Sie den Static-Parameter mit dem Parameter Name .

Typ:String[]
Position:0
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Static

Gibt an, dass dieses Cmdlet nur die statischen Eigenschaften und Methoden des Objekts abruft. Statische Eigenschaften und Methoden werden für die Klasse von Objekten, nicht für eine bestimmte Instanz der Klasse definiert.

Wenn Sie den Static-Parameter mit den Parametern View oder Force verwenden, ignoriert das Cmdlet diese Parameter. Wenn Sie den Static-Parameter mit dem MemberType-Parameter verwenden, werden nur die Elemente abgerufen, Get-Member die zu beiden Sätzen gehören.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-View

Gibt an, dass dieses Cmdlet nur bestimmte Typeneigenschaften und -methoden abruft. Geben Sie mindestens einen der Werte an. Der Standardwert ist "Angepasst", "Erweitert".

Zulässige Werte für diesen Parameter:

  • Basis. Ruft nur die ursprünglichen Eigenschaften und Methoden des .NET-Objekts ab (ohne Erweiterung oder Anpassung).
  • Angepasst. Ruft nur die Eigenschaften und Methoden ab, die im erweiterten PowerShell-Typsystem definiert sind.
  • Ausgedehnt. Ruft nur die Eigenschaften und Methoden ab, die in dateien Types.ps1xml oder mithilfe des Add-Member Cmdlets hinzugefügt wurden.
  • Alle. Ruft die Member in den Ansichten „Base“, „Adapted“ und „Extended“ ab.

Der Parameter View bestimmt die abgerufenen Elemente, nicht nur die Anzeige dieser Member.

Verwenden Sie zum Abrufen bestimmter Membertypen, z. B. Skripteigenschaften, den MemberType-Parameter . Wenn Sie die Parameter "MemberType " und "View" im selben Befehl verwenden, werden die Elemente abgerufen, Get-Member die zu beiden Sätzen gehören. Wenn Sie die Parameter "Static " und "View " im selben Befehl verwenden, wird der Parameter "View" ignoriert.

Typ:PSMemberViewTypes
Zulässige Werte:Extended, Adapted, Base, All
Position:Named
Standardwert:Adapted, Extended
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

PSObject

Sie können jedes Objekt an dieses Cmdlet weiterleiten.

Ausgaben

MemberDefinition

Dieses Cmdlet gibt ein MemberDefinition für jede Eigenschaft oder Methode zurück, die sie abruft.

Hinweise

PowerShell enthält die folgenden Aliase für Get-Member:

  • Alle Plattformen:
    • gm

Sie können Informationen zu einem Auflistungsobjekt entweder mithilfe des InputObject-Parameters abrufen oder indem Sie das Objekt, dem ein Komma vorangestellt ist, an Get-Member.

Sie können die $This automatische Variable in Skriptblöcken verwenden, die die Werte neuer Eigenschaften und Methoden definieren. Die $This Variable bezieht sich auf die Instanz des Objekts, zu der die Eigenschaften und Methoden hinzugefügt werden. Weitere Informationen zur $This Variablen finden Sie unter about_Automatic_Variables.

Wenn Sie ein Objekt übergeben, das einen Typ darstellt, z. B. ein Typliteral, [int]Get-Member geben Informationen zum [System.RuntimeType] Typ zurück. Wenn Sie jedoch den Static-Parameter verwenden, werden die statischen Elemente des spezifischen Typs zurückgegeben, Get-Member der von der System.RuntimeType Instanz dargestellt wird.