Freigeben über

Get-Member

  • Referenz
Modul:
Microsoft.PowerShell.Utility

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.

Um das -Objekt anzugeben, verwenden Sie den InputObject-Parameter , oder übergeben Sie ein Objekt an Get-Member. Zum Abrufen von Informationen zu statischen Membern, den Membern der -Klasse und nicht der instance, verwenden Sie den Static-Parameter. Verwenden Sie den MemberType-Parameter, um nur bestimmte Membertypen wie NoteProperties abzurufen.

Beispiele

Beispiel 1: Abrufen der Member von Prozessobjekten

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

Da der Get-Member Teil des Befehls über keine Parameter verfügt, verwendet er Standardwerte für die Parameter. Standardmäßig Get-Member 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 Member (Eigenschaften und Methoden) der vom Get-Service Cmdlet abgerufenen Dienstobjekte abgerufen, einschließlich der systeminternen Member wie PSBase, PSObject und der methoden get_ und set_ .

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

Der Get-Member Befehl verwendet den Force-Parameter , um der Anzeige die systeminternen Member und vom Compiler generierten Member der Objekte hinzuzufügen. Sie können diese Eigenschaften und Methoden auf die gleiche Weise verwenden wie eine angepasste Methode des Objekts. Der zweite Befehl veranschaulicht, wie Sie den Wert der PSBase-Eigenschaft des Zeitplandiensts anzeigen können.

Beispiel 3: Abrufen erweiterter Member von Dienstobjekten

In diesem Beispiel werden die Methoden und Eigenschaften von Dienstobjekten abgerufen, 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 View-Parameter , um nur die erweiterten Member der Dienstobjekte abzurufen. In diesem Fall ist der erweiterte Member 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 in Ereignisanzeige abgerufen.

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 dem Wert für NoteProperty ihre 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 mit einer MachineName-Eigenschaft in der Ausgabe aus einer Liste von Cmdlets abgerufen.

Die $list Variable enthält eine Liste von Cmdlets, die ausgewertet werden sollen. Die foreach-Anweisung ruft jeden Befehl auf und sendet die Ergebnisse an Get-Member. Der Parameter Name beschränkt die Ergebnisse von Get-Member auf 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 über eine MachineName-Eigenschaft verfügen.

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 ein Objektarray an Get-Memberübergeben, gibt das Cmdlet eine Memberliste für jeden eindeutigen Objekttyp im Array zurück. Wenn Sie das Array mit dem InputObject-Parameter ü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 zu sehen, wenn das Array an Get-Memberübergeben wird. Wenn $array mit dem InputObject-ParameterGet-Member übergeben wird, werden die Member 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

Parameter

-Force

Fügt der Anzeige die systeminternen Member und die vom Compiler generierten get_ - und set_ -Methoden hinzu. In der folgenden Liste werden die Eigenschaften beschrieben, die hinzugefügt werden, wenn Sie den Force-Parameter verwenden:

  • 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 im erweiterten PowerShell-Typsystem definierten Eigenschaften und Methoden.
  • 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 der Objekttypen, die das Objekt nach Genauigkeit beschreiben. 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 standardmäßig Get-Member diese Eigenschaften in allen Ansichten mit Ausnahme von Base und Adapt ab, zeigt sie jedoch nicht an.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Gibt das Objekt an, dessen Member abgerufen werden.

Die Verwendung des InputObject-Parameters ist nicht identisch mit dem Piping eines Objekts an Get-Member. Es gibt die folgenden Unterschiede:

  • Wenn Sie eine Auflistung von -Objekten an Get-Memberübergeben, Get-Member ruft die Member der einzelnen Objekte in der Auflistung ab, z. B. die Eigenschaften jeder Zeichenfolge in einem Array von Zeichenfolgen.
  • Wenn Sie InputObject zum Übermitteln einer Auflistung von -Objekten verwenden, Get-Member ruft die Member der Auflistung ab, z. B. die Eigenschaften des Arrays in einem Array von Zeichenfolgen.
Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-MemberType

Gibt den Membertyp an, den dieses Cmdlet abruft. Die Standardeinstellung ist Alle.

Zulässige Werte für diesen Parameter:

  • AliasProperty
  • CodeProperty
  • Eigenschaft
  • NoteProperty
  • ScriptProperty
  • Eigenschaften
  • PropertySet
  • Methode
  • CodeMethod
  • ScriptMethod
  • Methoden
  • ParameterizedProperty
  • MemberSet
  • Ereignis
  • Dynamisch
  • Alle

Informationen zu diesen Werten finden Sie unter PSMemberTypes-Enumeration.

Nicht alle Objekte verfügen über jeden Membertyp. Wenn Sie einen Membertyp angeben, den das Objekt nicht aufweist, gibt PowerShell einen NULL-Wert zurück.

Um verwandte Membertypen, wie z. B. alle erweiterten Member abzurufen, verwenden Sie den View-Parameter. Wenn Sie den MemberType-Parameter mit den Parametern Static oder View verwenden, ruft die Member ab, Get-Member die zu beiden Sätzen gehören.

Type:PSMemberTypes
Aliases:Type
Accepted values:AliasProperty, CodeProperty, Property, NoteProperty, ScriptProperty, Properties, PropertySet, Method, CodeMethod, ScriptMethod, Methods, ParameterizedProperty, MemberSet, Event, Dynamic, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 dem View-Parameter verwenden, wird der View-Parameter ignoriert. Wenn Sie den Static-Parameter mit dem MemberType-Parameter verwenden, ruft nur die Member ab, Get-Member die zu beiden Sätzen gehören.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.
  • Erweiterte. Ruft nur die Eigenschaften und Methoden ab, die in einer Types.ps1xml Datei oder mithilfe des Add-Member Cmdlets hinzugefügt wurden.
  • Alle. Ruft die Member in den Ansichten „Base“, „Adapted“ und „Extended“ ab.

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

Verwenden Sie den MemberType-Parameter , um bestimmte Membertypen abzurufen, z. B. Skripteigenschaften. Wenn Sie die Parameter MemberType und View im gleichen Befehl verwenden, ruft die Member ab, Get-Member die zu beiden Sätzen gehören. Wenn Sie die Parameter Static und View im gleichen Befehl verwenden, wird der View-Parameter ignoriert.

Type:PSMemberViewTypes
Accepted values:Extended, Adapted, Base, All
Position:Named
Default value:Adapted, Extended
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

PSObject

Sie können jedes Objekt an übergeben Get-Member.

Ausgaben

MemberDefinition

Get-Member gibt ein -Objekt für jede Eigenschaft oder Methode zurück, die bzw. die abgerufen wird.

Hinweise

Sie können Informationen zu einem Auflistungsobjekt abrufen, indem Sie entweder den InputObject-Parameter verwenden oder das Objekt mit einem Komma an Get-Memberpipieren.

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 instance des Objekts, dem 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 wie [int], Get-Member geben Sie Informationen zum [System.RuntimeType] Typ zurück. Wenn Sie jedoch den Static-Parameter verwenden, gibt die statischen Member des spezifischen Typs zurück, Get-Member der durch den System.RuntimeType instance dargestellt wird.