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

Descrição
-----------
Estes comandos adicionam a propriedade de nota Status a um objeto DirectoryInfo retornado por Get-ChildItem e atribuem a ele um valor "done". 

O primeiro comando obtém o primeiro objeto que Get-Childitem retorna (índice 0).

O segundo comando adiciona a propriedade de nota.

O terceiro comando usa um operador de pipeline (|) para enviar o objeto atualizado para o cmdlet Get-Member. A saída mostra que a propriedade foi adicionada.

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

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

C:\PS> $a.filelength

Descrição
-----------
Estes comandos adicionam uma propriedade de alias FileLength a um objeto DirectoryInfo retornado por Get-ChildItem. A nova propriedade é um alias para a propriedade Length. 

O primeiro comando obtém o primeiro objeto que Get-Childitem retorna (índice 0).

O segundo comando adiciona a propriedade de alias.

O terceiro comando retorna o valor da nova propriedade FileLength.

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

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

C:\PS> $a.StringUse

Descrição
-----------
Estes comandos adicionam a propriedade StringUse a uma cadeia de caracteres. Como a cadeia de caracteres não é um objeto PSObject, você deve incluir o parâmetro PassThru no comando para salvar a cadeia de caracteres estendida na variável. O último comando no exemplo exibe a nova propriedade.

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

Descrição
-----------
Estes comandos adicionam um método de script a um objeto da cadeia de caracteres. O método de script expõe o método Split() da classe System.String .NET Framework Class Library, para facilitar o retorno de palavras individuais em uma cadeia de caracteres ao chamar um método nomeado "Words" no objeto da cadeia de caracteres. Lembre-se de que o parâmetro PassThru é especificado para forçar Add-Member a retornar o objeto da cadeia de caracteres estendida como saída para ser armazenado em uma variável $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

Descrição
-----------
Estes comandos adicionam a AliasProperty a um objeto EventLogEntry retornado pelos cmdlets Get-EventLog. A AliasProperty é nomeada "When" e é um alias da propriedade TimeWritten do objeto. O parâmetro SecondValue é utilizado para especificar que o valor da propriedade deve ser convertido para o tipo System.String quando acessado usando a AliasProperty; a propriedade TimeWritten é um objeto DateTime.

O primeiro comando usa o cmdlet Get-EventLog para recuperar o evento mais recente do log de eventos System e o armazena na variável $event. 

O segundo comando acessa a propriedade TimeWritten daquele evento e a envia para o cmdlet Get-Member para demonstrar que a propriedade é um tipo DateTime. Add-Member é usado para adicionar um membro AliasProperty à instância do objeto EventLogEntry armazenado na variável $event. O parâmetro Name é usado para definir o nome do novo membro para “When”; o parâmetro Value é usado para especificar que é um alias da propriedade TimeWritten. O parâmetro SecondValue é utilizado para indicar que, quando esse novo membro for usado, o valor que ele retorna deverá ser convertido de seu tipo para System.DateTime original para um tipo System.String. 

O terceiro comando acessa o novo membro e o envia para o cmdlet Get-Member, a fim de confirmar que é do 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)
   }
}

Descrição
-----------
Essa função copia todas as propriedades de um objeto para outro objeto.

O primeiro comando na função declara o nome da função e lista seus parâmetros. 

O loop Foreach usa o cmdlet Get-Member para obter cada uma das propriedades do objeto From. Os comandos em cada loop Foreach são executados em série em cada uma das propriedades.

O comando Add-Member adiciona a propriedade do objeto From para o objeto To como uma NoteProperty. Ele usa o parâmetro Force para permitir que o comando adicione membros com o mesmo nome de membro.

O último comando na função dá à nova propriedade o mesmo nome da propriedade original.