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 note 屬性加入至 Get-ChildItem 所傳回的 DirectoryInfo 物件中，並為它指派 "done" 的值。

第一個命令會取得 Get-Childitem 所傳回的第一個物件 (索引 0)。

第二個命令會加入 note 屬性。

第三個命令會使用管線運算子 (|)，將更新的物件傳送到 Get-Member Cmdlet。輸出會顯示已經加入此屬性。

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

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

C:\PS> $a.filelength

描述
-----------
這些命令會將 FileLength alias 屬性加入至 Get-ChildItem 所傳回的 DirectoryInfo 物件。新的屬性是 Length 屬性的別名。

第一個命令會取得 Get-Childitem 所傳回的第一個物件 (索引 0)。

第二個命令會加入 alias 屬性。

第三個命令會傳回新 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()

描述
-----------
這些命令會將指令碼方法加入至字串物件。這個指令碼方法公開 System.String .NET Framework 類別庫類別的 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

描述
-----------
這些命令會將 AliasProperty 加入至 Get-EventLog Cmdlet 所傳回的 EventLogEntry 物件。AliasProperty 的名稱為 "When"，而且是物件之 TimeWritten 屬性的別名。SecondValue 參數是用來指定：當使用 AliasProperty 存取屬性值時，必須將它轉換為類型 System.String；TimeWritten 屬性為 DateTime 物件。

第一個命令會使用 Get-EventLog Cmdlet，從系統事件記錄檔擷取最新的事件，並將它儲存在 $event 變數中。

第二個命令會存取該事件的 TimeWritten 屬性，並經由管道將它輸入至 Get-Member Cmdlet，表明該屬性為 DateTime 類型。然後使用 Add-Member 將 AliasProperty 成員加入至儲存於 $event 變數的 EventLogEntry 物件執行個體。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 物件的屬性加入至 To 物件當做 NoteProperty。它會使用 Force 參數讓此命令加入同名的成員。

函數的最後一個命令是將新屬性命名為與原始屬性同名。