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 オブジェクトに Status ノート プロパティを追加し、その値として "done" を設定します。

最初のコマンドは、Get-Childitem から返された最初のオブジェクト (インデックス 0) を取得します。

2 番目のコマンドは、ノート プロパティを追加します。

3 番目のコマンドは、パイプライン演算子 (|) を使用して、更新されたオブジェクトを Get-Member コマンドレットに送ります。出力結果を見ると、プロパティが追加されていることがわかります。

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) を取得します。

2 番目のコマンドは、エイリアス プロパティを追加します。

3 番目のコマンドは、新しい 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 Class Library クラスの 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 コマンドレットが返す EventLogEntry オブジェクトに AliasProperty を追加します。AliasProperty には "When" という名前が付けられ、オブジェクトの TimeWritten プロパティのエイリアスとなります。SecondValue パラメーターは、AliasProperty でアクセスされるときにプロパティ値を System.String 型に変換する必要があることを示すのに使用されています。TimeWritten プロパティは DateTime オブジェクトです。

最初のコマンドは、Get-EventLog コマンドレットを使用して System イベント ログから最新のイベントを取得し、$event 変数に保存しています。

2 番目のコマンドは、そのイベントの TimeWritten プロパティにアクセスし、パイプを使用してそれを Get-Member コマンドレットに渡すことで、プロパティが DateTime 型であることを示します。次に Add-Member を使用して、$event 変数に格納されている EventLogEntry オブジェクト インスタンスに AliasProperty メンバーを追加します。Name パラメーターは、新しいメンバーの名前を "When" に設定するために使用され、Value パラメーターは、When が TimeWritten プロパティのエイリアスであることを指定するために使用されています。SecondValue パラメーターは、この新しいメンバーが返す値を元の System.DateTime 型から System.String 型に変換する必要があることを示すのに使用されています。

3 番目のコマンドは、新しいメンバーにアクセスし、パイプを使用してそれを 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)
   }
}

説明
-----------
この関数は、1 つのオブジェクトのすべてのプロパティを別のオブジェクトにコピーします。

関数の最初のコマンドは、関数名を宣言し、パラメーターをリストします。

For-Each ループは、Get-Member コマンドレットを使用して From オブジェクトの各プロパティを取得します。Foreach ループ内のコマンドは、各プロパティで順次実行されます。

Add-Member コマンドは、From オブジェクトのプロパティを NoteProperty として To オブジェクトに追加します。また、Force パラメーターを使用することで、コマンドで同じメンバー名のメンバーを追加しています。

関数の最後のコマンドは、新しいプロパティに元のプロパティと同じ名前を付けます。