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

Описание
-----------
Эти команды добавляют свойство-примечание Status в объект DirectoryInfo, возвращенный командлетом Get-ChildItem, и присваивают ему значение "done". 

Первая команда получает первый объект, возвращаемый командлетом Get-Childitem (индекс 0).

Вторая команда добавляет свойство-примечание.

Третья команда передает обновленный объект командлету Get-Member с помощью оператора конвейера (|). Вывод показывает, что свойство было добавлено.

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

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

C:\PS> $a.filelength

Описание
-----------
Эти команды добавляют свойство-псевдоним FileLength в объект DirectoryInfo, возвращенный командлетом Get-ChildItem. Новое свойство является псевдонимом для свойства Length. 

Первая команда получает первый объект, возвращаемый командлетом Get-Childitem (индекс 0).

Вторая команда добавляет свойство-псевдоним.

Третья команда возвращает значение нового свойства FileLength.

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

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

C:\PS> $a.StringUse

Описание
-----------
Эти команды добавляют свойство StringUse для строки. Так как строка не является объектом PSObject, необходимо включить в команду параметр PassThru, чтобы сохранить расширенную строку в переменной. Последняя команда примера выводит новое свойство.

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

Описание
-----------
Эти команды добавляют в строковый объект метод-скрипт. Метод-скрипт предоставляет доступ к методу Split() класса System.String библиотеки классов .NET Framework, обеспечивая удобный способ получения отдельных слов строки путем вызова метода "Words" для объекта-строки. Обратите внимание, что используется параметр PassThru, чтобы командлет Add-Member возвратил расширенный объект-строку для сохранения в переменной $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

Описание
-----------
Эти команды добавляют элемент AliasProperty в объект EventLogEntry, возвращенный командлетом Get-EventLog. Свойство AliasProperty называется "When" и является псевдонимом имеющегося у объекта свойства TimeWritten. Параметр SecondValue указывает, что при доступе к свойству с помощью псевдонима AliasProperty значение свойства должно быть преобразовано в тип System.String. Свойство TimeWritten является объектом типа DateTime.

В первой команде с помощью командлета Get-EventLog извлекается последнее событие из системного журнала событий и сохраняется в переменной $event. 

Вторая команда получает доступ к свойству TimeWritten этого события и передает его по конвейеру командлету Get-Member, чтобы показать, что это свойство принадлежит к типу DateTime. Командлет Add-Member затем используется для добавления элемента AliasProperty в экземпляр объекта EventLogEntry, сохраненного в переменной $event. Параметр Name используется для присвоения новому элементу имени "When", а параметр Value — для указания того, что этот элемент является псевдонимом свойства "TimeWritten". Параметр SecondValue указывает, что при использовании этого нового элемента тип возвращаемого им значения должен быть преобразован из System.DateTime в System.String. 

Третья команда обращается к новому элементу и передает его по конвейеру командлету Get-Member, чтобы показать, что он принадлежит к типу 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)
   }
}

Описание
-----------
Эта функция копирует все свойства одного объекта в другой объект.

В первой команде функции объявляется имя функции и перечисляются ее параметры. 

В цикле Foreach с помощью командлета Get-Member происходит получение всех свойств объекта "From". Команды, расположенные внутри цикла Foreach, последовательно применяются к каждому из свойств.

Команда Add-Member добавляет свойство объекта "From" объекту "To" в качестве свойства NoteProperty. Использование параметра Force позволяет добавлять элементы с одинаковыми именами.

В последней команде новому свойству присваивается имя исходного свойства.