Add-Member

Add-Member [-MemberType] {<AliasProperty> | <CodeProperty> | <Property> | <NoteProperty> | <ScriptProperty> | <Properties> | <PropertySet> | <Method> | <CodeMethod> | <ScriptMethod> | <Methods> | <ParameterizedProperty> | <MemberSet> | <Event> | <All>} [-Name] <string> -InputObject <psobject> [[-Wert] <Object>] [[-SecondValue] <Object>] [-Force] [-PassThru] [<CommonParameters>]

C:\PS>$a = (get-childitem)[0]

C:\PS> $a | add-member -membertype noteproperty -name Status -value done

C:\PS> $a | get-member -type noteproperty

   TypeName: System.IO.DirectoryInfo

Name          MemberType   Definition
----          ----------   ----------
PSChildName   NoteProperty System.String PSChildName=Co
PSDrive       NoteProperty System.Management.Automation
PSIsContainer NoteProperty System.Boolean PSIsContainer
PSParentPath  NoteProperty System.String PSParentPath=M
PSPath        NoteProperty System.String PSPath=Microso
PSProvider    NoteProperty System.Management.Automation
Status        NoteProperty System.String Status=done

Beschreibung
-----------
Mit diesen Befehlen wird einem von Get-ChildItem zurückgegebenen DirectoryInfo-Objekt eine Status-Notizeigenschaft hinzugefügt und der Wert "done" zugewiesen. 

Mit dem ersten Befehl wird das erste Objekt abgerufen, das Get-Childitem zurückgibt (Index 0).

Mit dem zweiten Befehl wird die Notizeigenschaft hinzugefügt.

Mit dem dritten Befehl wird das aktualisierte Objekt mit einem Pipelineoperator (|) an das Cmdlet "Get-Member" gesendet. Aus der Ausgabe ist ersichtlich, dass die Eigenschaft hinzugefügt wurde.

C:\PS>$a = (get-childitem)[0]

C:\PS> $a | add-member -membertype aliasproperty -name FileLength -value Length 

C:\PS> $a.filelength

Beschreibung
-----------
Mit diesen Befehlen wird die FileLength Aliaseigenschaft einem von Get-ChildItem zurückgegebenen DirectoryInfo-Objekt hinzugefügt. Die neue Eigenschaft ist ein Alias für die Length-Eigenschaft. 

Mit dem ersten Befehl wird das erste Objekt abgerufen, das Get-Childitem zurückgibt (Index 0).

Mit dem zweiten Befehl wird die Aliaseigenschaft hinzugefügt.

Mit dem dritten Befehl wird der Wert der neuen FileLength-Eigenschaft zurückgegeben.

C:\PS>$a = "a string"

C:\PS> $a = $a | add-member -membertype noteproperty -name StringUse -value Display -passthru

C:\PS> $a.StringUse

Beschreibung
-----------
Mit diesen Befehlen wird die StringUse-Eigenschaft einer Zeichenfolge hinzugefügt. Da die Zeichenfolge kein PSObject-Objekt ist, müssen Sie den PassThru-Parameter in den Befehl einschließen, um die erweiterte Zeichenfolge in der Variablen zu speichern. Mit dem letzten Befehl im Beispiel wird die neue Eigenschaft angezeigt.

C:\PS>$a = "this is a string"

C:\PS> $a = add-member -inputobject $a -membertype scriptmethod -name words `
-value {$this.split()} -passthru

C:\PS> $a.words()

Beschreibung
-----------
Mit diesen Befehlen wird einem Zeichenfolgenobjekt eine Skriptmethode hinzugefügt. Die Skriptmethode macht die Split()-Methode der System.String-Klasse der .NET Framework-Klassenbibliothek verfügbar, um die einzelnen Wörter in einer Zeichenfolge durch den Aufruf der Methode mit dem Namen "Words" für das Zeichenfolgenobjekt bequem zurückgeben zu können. Beachten Sie, dass der PassThru-Parameter angegeben wurde, um die Rückgabe des erweiterten Zeichenfolgenobjekts durch "Add-Member" als Ausgabe zu erzwingen, die in der Variablen "$a" gespeichert wird.

C:\PS>$event = get-eventlog -logname system -newest 1

C:\PS> $event.TimeWritten | get-member

C:\PS> add-member -inputobject $event -membertype aliasproperty -name When `
-value TimeWritten -secondvalue System.String

C:\PS> $event.When | get-member

Beschreibung
-----------
Mit diesen Befehlen wird einem vom Cmdlet "Get-EventLog" zurückgegebenen EventLogEntry-Objekt eine AliasProperty hinzugefügt. Der Name der AliasProperty lautet "When" und ist ein Alias für die TimeWritten-Eigenschaft des Objekts. Mit dem SecondValue-Parameter wird angegeben, dass der Eigenschaftenwert in den Typ "System.String" konvertiert werden soll, wenn mit der AliasProperty auf ihn zugegriffen wird. Die TimeWritten-Eigenschaft ist ein DateTime-Objekt.

Im ersten Befehl wird das letzte Ereignis aus dem Systemereignisprotokoll mit dem Cmdlet "Get-EventLog" abgerufen und in der Variablen "$event" gespeichert. 

Der zweite Befehl greift auf die TimeWritten-Eigenschaft dieses Ereignisses zu und übergibt es über die Pipeline an das Cmdlet "Get-Member", um zu veranschaulichen, dass es sich bei der Eigenschaft um einen DateTime-Typ handelt. Anschließend wird Add-Member verwendet, um der Instanz des in der Variablen "$event" gespeicherten EventLogEntry-Objekts ein AliasProperty-Element hinzuzufügen. Mit dem Name-Parameter wird der Name das neuen Elements auf "When" festgelegt, und mit dem Value-Parameter wird angegeben, dass der Name ein Alias für die TimeWritten-Eigenschaft ist. Mit dem SecondValue-Parameter wird angegeben, dass der bei Verwendung dieses neuen Elements zurückgegebene Wert vom ursprünglichen Typ "System.DateTime" in den Typ "System.String" umgewandelt werden soll. 

Der dritte Befehl greift auf das neue Element zu und übergibt es über die Pipeline an das Cmdlet "Get-Member", um zu bestätigen, dass es vom Typ "System.String" ist.

C:\PS>function Copy-Property ($From, $To)

{
  foreach ($p in Get-Member -InputObject $From -MemberType Property)
  {
     Add-Member -InputObject $To -MemberType NoteProperty -Name $p.Name 
     -Value $From.$($p.Name) -Force

     $To.$($p.Name) = $From.$($p.Name)
   }
}

Beschreibung
-----------
Diese Funktion kopiert alle Eigenschaften eines Objekts in ein anderes Objekt.

Im ersten Befehl der Funktion wird der Funktionsname deklariert, und ihre Parameter werden aufgeführt. 

In der Foreach-Schleife werden die einzelnen Eigenschaften des From-Objekts mit dem Cmdlet "Get-Member" abgerufen. Die Befehle in der Foreach-Schleife werden der Reihe nach für jede der Eigenschaften ausgeführt.

Mit dem Befehl "Add-Member" wird dem To-Objekt die Eigenschaft des From-Objekts als NoteProperty hinzugefügt. Durch Verwendung des Force-Parameters können mit dem Befehl Elemente hinzugefügt werden, die den gleichen Elementnamen aufweisen.

Im letzten Befehl der Funktion wird der neuen Eigenschaft der Name der ursprünglichen Eigenschaft zugewiesen.