Add-Member

Add-Member [-MemberType] {<AliasProperty> | <CodeProperty> | <Property> | <NoteProperty> | <ScriptProperty> | <Properties> | <PropertySet> | <Method> | <CodeMethod> | <ScriptMethod> | <Methods> | <ParameterizedProperty> | <MemberSet> | <Event> | <All>} [-Name] <string> -InputObject <psobject> [[-Value] <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

Descripción
-----------
Estos comandos agregan la propiedad de nota Status a un objeto DirectoryInfo devuelto por Get-ChildItem y le asignan el valor "done". 

El primer comando obtiene el primer objeto que Get-Childitem devuelve (índice 0).

El segundo comando agrega la propiedad de nota.

El tercer comando usa un operador de canalización (|) para enviar el objeto actualizado al cmdlet Get-Member. En el resultado se muestra que se ha agregado la propiedad.

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

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

C:\PS> $a.filelength

Descripción
-----------
Estos comandos agregan la propiedad de alias FileLength a un objeto DirectoryInfo devuelto por Get-ChildItem. La nueva propiedad es un alias de la propiedad Length. 

El primer comando obtiene el primer objeto que Get-Childitem devuelve (índice 0).

El segundo comando agrega la propiedad de alias.

El tercer comando devuelve el valor de la nueva propiedad FileLength.

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

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

C:\PS> $a.StringUse

Descripción
-----------
Estos comandos agregan la propiedad StringUse a una cadena. Dado que la cadena no es un objeto PSObject, se debe incluir el parámetro PassThru en el comando para guardar la cadena extendida en la variable. El último comando del ejemplo muestra la nueva propiedad.

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()

Descripción
-----------
Estos comandos agregan un método de script a un objeto de cadena. El método de script expone el método Split() de la clase System.String de la biblioteca de clases de .NET Framework para permitir que se devuelvan las distintas palabras de una cadena llamando a un método de identificación de palabras en el objeto de cadena. Tenga en cuenta que se ha especificado el parámetro PassThru para que Add-Member devuelva el objeto de cadena extendido como resultado que se va a almacenar en la variable $a.

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

Descripción
-----------
Estos comandos agrega un miembro AliasProperty a un objeto EventLogEntry devuelto por los cmdlets Get-EventLog. El miembro AliasProperty se denomina "When" y es un alias de la propiedad TimeWritten del objeto. El parámetro SecondValue se usa para indicar que el valor de la propiedad debe convertirse al tipo System.String cuando se obtiene acceso a través del miembro AliasProperty (la propiedad TimeWritten es un objeto DateTime).

La primera línea del comando usa el cmdlet Get-EventLog para recuperar el evento más reciente del registro de eventos del sistema y lo almacena en la variable $event. 

El segundo comando obtiene acceso a la propiedad TimeWritten de ese evento y la canaliza al cmdlet Get-Member para mostrar que la propiedad es del tipo DateTime. A continuación, se usa Add-Member para agregar un miembro AliasProperty a la instancia del objeto EventLogEntry que está almacenado en la variable $event. El parámetro Name se usa para definir el nombre del nuevo miembro como "When", mientras que el parámetro Value se usa para especificar que se trata de un alias de la propiedad TimeWritten. El parámetro SecondValue se usa para indicar que, cuando se usa este nuevo miembro, el valor que devuelve debe convertirse de su tipo original, System.DateTime, al tipo System.String. 

El tercer comando obtiene acceso al nuevo miembro y lo canaliza al cmdlet Get-Member para confirmar que es del tipo System.String.

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)
   }
}

Descripción
-----------
Esta función copia todas las propiedades de un objeto en otro objeto.

El primer comando de la función declara el nombre de función y muestra sus parámetros. 

El bucle Foreach utiliza el cmdlet Get-Member para obtener cada una de las propiedades del objeto From. Los comandos dentro del bucle Foreach se ejecutan en serie en cada una de las propiedades.

El comando Add-Member agrega la propiedad del objeto From al objeto To como una propiedad NoteProperty. Utiliza el parámetro Force para que el comando pueda agregar miembros con el mismo nombre.

El último comando de la función asigna a la nueva propiedad el mismo nombre que tiene la propiedad original.