Get-Member

Get-Member [[-Name] <string[]>] [-Force] [-InputObject] [-MemberType {<AliasProperty> | <CodeProperty> | <Property> | <NoteProperty> | <ScriptProperty> | <Properties> | <PropertySet> | <Method> | <CodeMethod> | <ScriptMethod> | <Methods> | <ParameterizedProperty> | <MemberSet> | <Event> | <All>}] [-Static] [-View {<Extended> | <Adapted> | <Base> | <All>}] [<CommonParameters>]

C:\PS>get-service | get-member


   TypeName: System.ServiceProcess.ServiceController

Name                      MemberType    Definition
----                      ----------    ----------
Name                      AliasProperty Name = ServiceName
Close                     Method        System.Void Close()
Continue                  Method        System.Void Continue()
CreateObjRef              Method        System.Runtime.Remoting.ObjRef CreateObjRef(Type requestedType)
Dispose                   Method        System.Void Dispose()
Equals                    Method        System.Boolean Equals(Object obj)
ExecuteCommand            Method        System.Void ExecuteCommand(Int32 command)
GetHashCode               Method        System.Int32 GetHashCode()
GetLifetimeService        Method        System.Object GetLifetimeService()
GetType                   Method        System.Type GetType()
InitializeLifetimeService Method        System.Object InitializeLifetimeService()
Pause                     Method        System.Void Pause()
Refresh                   Method        System.Void Refresh()
Start                     Method        System.Void Start(), System.Void Start(String[] args)
Stop                      Method        System.Void Stop()
ToString                  Method        System.String ToString()
WaitForStatus             Method        System.Void WaitForStatus(ServiceControllerStatus desiredStatus), System.Voi...
CanPauseAndContinue       Property      System.Boolean CanPauseAndContinue {get;}
CanShutdown               Property      System.Boolean CanShutdown {get;}
CanStop                   Property      System.Boolean CanStop {get;}
Container                 Property      System.ComponentModel.IContainer Container {get;}
DependentServices         Property      System.ServiceProcess.ServiceController[] DependentServices {get;}
DisplayName               Property      System.String DisplayName {get;set;}
MachineName               Property      System.String MachineName {get;set;}
ServiceHandle             Property      System.Runtime.InteropServices.SafeHandle ServiceHandle {get;}
ServiceName               Property      System.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;}
Status                    Property      System.ServiceProcess.ServiceControllerStatus Status {get;}

Beschreibung
-----------
Mit diesem Befehl werden die Eigenschaften und Methoden der Prozessobjekte (System.ServiceProcess.ServiceController) angezeigt, die vom Cmdlet "Get-Service" generiert werden.

Die Ausgabe des Befehls "Get-Service" wird mithilfe des Pipelineoperators (|) an Get-Member gesendet.

Da Get-Member im Befehl über keine Parameter verfügt, werden alle Standardwerte verwendet. Mit dem Befehl werden alle Elementtypen abgerufen, jedoch werden keine statischen Elemente abgerufen und keine systeminternen Elemente angezeigt.

C:\PS>get-service | get-member -force

C:\PS> (get-service -schedule).psbase

Beschreibung
-----------
In diesem Beispiel werden alle Elemente (Eigenschaften und Methoden) der vom Cmdlet "Get-Service" abgerufenen Dienstobjekte (System.ServiceProcess.ServiceController), einschließlich der systeminternen Elemente, z. B. PSBase und PSObject, sowie der get_-Methode und der set_-Methode abgerufen.

Im ersten Befehl werden mit dem Cmdlet "Get-Service" Objekte abgerufen, die die Dienste auf dem System darstellen. Die Dienstobjekte werden mit einem Pipelineoperator (|) an das Cmdlet "Get-Member" übergeben.

Im Befehl "Get-Member" werden die systeminternen Elemente und die vom Compiler generierten Elemente der Objekte mithilfe des Force-Parameters der Anzeige hinzugefügt. Mit Get-Member werden diese Elemente abgerufen, jedoch standardmäßig ausgeblendet.

Sie können diese Eigenschaften und Methoden auf die gleiche Weise wie eine angepasste Methode des Objekts verwenden. Im zweiten Befehl wird veranschaulicht, wie der Wert der PSBase-Eigenschaft des Diensts "Schedule" angezeigt wird.

C:\PS>get-service	| get-member -view extended

   TypeName: System.ServiceProcess.ServiceController

Name MemberType    Definition
---- ----------    ----------
Name AliasProperty Name = ServiceName

Beschreibung
-----------
Mit diesem Befehl werden die Methoden und Eigenschaften von Dienstobjekten abgerufen, die mit der Datei "Types.ps1xml" oder dem Cmdlet "Add-Member" erweitert wurden. 


Im Befehl "Get-Member" werden mithilfe des View-Parameters nur die erweiterten Elemente der Dienstobjekte abgerufen. In diesem Fall ist das erweiterte Element die Name-Eigenschaft, die eine Aliaseigenschaft der ServiceName-Eigenschaft ist.

C:\PS>get-eventlog -log system | gm -membertype scriptproperty

   TypeName: System.Diagnostics.EventLogEntry

Name    MemberType     Definition
----    ----------     ----------
EventID ScriptProperty System.Object EventID {get=$this.get_EventID() -band 0xFFFF;}

Beschreibung
-----------
Mit diesem Befehl werden die Skripteigenschaften von Ereignisprotokollobjekten im Systemprotokoll der Ereignisanzeige abgerufen. In diesem Fall ist die einzige Skripteigenschaft die EventID.

C:\PS>get-eventlog -log system | get-member -membertype scriptproperty


   TypeName: System.Diagnostics.EventLogEntry

Name    MemberType     Definition
----    ----------     ----------
EventID ScriptProperty System.Object EventID {get=$this.get_EventID() -band 0xFFFF;}

Beschreibung
-----------
Mit diesem Befehl werden die Skripteigenschaften von Ereignisprotokollobjekten im Systemprotokoll der Ereignisanzeige abgerufen. 

Im Befehl werden mithilfe des MemberType-Parameters nur Objekte abgerufen, deren MemberType-Eigenschaft den Wert "AliasProperty" aufweist.

Der Befehl gibt die EventID-Eigenschaft des EventLog-Objekts zurück.

C:\PS>$a = "get-process", "get-service", "get-culture", "get-psdrive", "get-executionpolicy"

C:\PS> foreach ($cmdlet in $a) {invoke-expression $cmdlet | get-member -name machinename}

TypeName: System.Diagnostics.Process

Name        MemberType Definition
----        ---------- ----------
MachineName Property   System.String MachineName {get;}


   TypeName: System.ServiceProcess.ServiceController

Name        MemberType Definition
----        ---------- ----------
MachineName Property   System.String MachineName {get;set;}

Beschreibung
-----------
Mit diesem Befehl werden aus einer Liste von Cmdlets Objekte abgerufen, die über die MachineName-Eigenschaft verfügen.

Im ersten Befehl werden die Namen mehrerer Cmdlets in der Variablen "$a" gespeichert.

Im zweiten Befehl werden die einzelnen Befehle mithilfe einer ForEach-Anweisung aufgerufen, die Ergebnisse an Get-Member gesendet und die Ergebnisse von Get-Member auf Elemente mit dem Namen "MachineName" beschränkt.

In den Ergebnissen wird gezeigt, dass nur Prozessobjekte (System.Diagnostics.Process) und Dienstobjekte (System.ServiceProcess.ServiceController) über die MachineName-Eigenschaft verfügen.

C:\PS>$a = get-member -inputobject @(1)

C:\PS>$a.count

1

C:\PS> $a = get-member -inputobject 1,2,3

   TypeName: System.Object[]
Name               MemberType    Definition
----               ----------    ----------
Count              AliasProperty Count = Length
Address            Method        System.Object& Address(Int32 )
Clone              Method        System.Object Clone()
...

C:\PS>$a.count
1

Beschreibung
-----------
In diesem Beispiel wird veranschaulicht, wie die Eigenschaften und Methoden eines Objektarrays gesucht werden, wenn nur ein Objekt des angegebenen Typs vorhanden ist.

Da mit dem Befehl die Eigenschaften eines Arrays gesucht werden sollen, wird im ersten Befehl der InputObject-Parameter verwendet. Mit dem at-Symbol (@) wird ein Array angegeben. In diesem Fall enthält das Array nur ein Objekt, die ganze Zahl 1. 

Der dritte Befehl ruft mit dem Cmdlet "Get-Member" die Eigenschaften und Methoden eines Arrays von ganzen Zahlen ab und speichert diese in der Variablen "$a".

Im vierten Befehl wird die Anzahl der Objekte in der Variablen "$a" mithilfe der Count-Eigenschaft ermittelt.