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

说明
-----------
这些命令将状态注释属性添加到 Get-ChildItem 返回的 DirectoryInfo 对象，并向该对象赋予一个“done”值。

第一个命令获取 Get-Childitem 返回的第一个对象（索引 0）。

第二个命令用于添加注释属性。

第三个命令使用管道运算符 (|) 将更新后的对象发送到 Get-Member cmdlet。输出显示已添加属性。

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

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

C:\PS> $a.filelength

说明
-----------
这些命令将向 Get-ChildItem 返回的 DirectoryInfo 对象添加 FileLength 别名属性。新属性是 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()

说明
-----------
这些命令将向字符串对象添加脚本方法。脚本方法公开了 .NET Framework 类库类 System.String 的 Split() 方法，以便于通过对字符串对象调用名为“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

说明
-----------
这些命令将向由 Get-EventLog cmdlet 返回的 EventLogEntry 对象添加 AliasProperty。AliasProperty 将命名为“When”，且此属性是该对象的 TimeWritten 属性的别名。SecondValue 参数用于指定在使用 AliasProperty 进行访问时属性值应转换为类型 System.String；TimeWritten 属性为 DateTime 对象。

第一个命令使用 Get-EventLog cmdlet 从 System 事件日志中检索最近发生的事件，并将其存储在 $event 变量中。

第二个命令用于访问该事件的 TimeWritten 属性，并通过管道将其传递给 Get-Member cmdlet 以表明该属性是 DateTime 类型。然后使用 Add-Member 向存储在 $event 变量中的 EventLogEntry 对象的实例添加 AliasProperty 成员。Name 参数用于将新成员的名称设置为“When”，而 Value 参数用于指定该新成员名称为 TimeWritten 属性的别名。SecondValue 参数用于指示，在使用此新成员时，它所返回的值应从其原来的 System.DateTime 类型转换为 System.String 类型。

第三个命令用于访问新成员，并通过管道将其传递给 Get-Member cmdlet 以确认它属于 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 cmdlet 来获取 From 对象的每个属性。将针对每个属性依次执行 Foreach 循环中的命令。

Add-Member 命令将该 From 对象的属性当作 NoteProperty 添加到 To 对象中。它采用 Force 参数以便该命令可以添加同名的成员。

函数中的最后一个命令为新属性指定的名称与原属性的名称相同。