Add-Member

リファレンス

モジュール:: Microsoft.PowerShell.Utility

PowerShell オブジェクトのインスタンスにカスタムプロパティとメソッドを追加します。

構文

Add-Member
   -InputObject <PSObject>
   -TypeName <String>
   [-PassThru]
   [<CommonParameters>]

Add-Member
   -InputObject <PSObject>
   [-TypeName <String>]
   [-Force]
   [-PassThru]
   [-NotePropertyMembers] <IDictionary>
   [<CommonParameters>]

Add-Member
   -InputObject <PSObject>
   [-TypeName <String>]
   [-Force]
   [-PassThru]
   [-NotePropertyName] <String>
   [-NotePropertyValue] <Object>
   [<CommonParameters>]

Add-Member
   -InputObject <PSObject>
   [-MemberType] <PSMemberTypes>
   [-Name] <String>
   [[-Value] <Object>]
   [[-SecondValue] <Object>]
   [-TypeName <String>]
   [-Force]
   [-PassThru]
   [<CommonParameters>]

説明

この Add-Member コマンドレットを使用すると、PowerShell オブジェクトのインスタンスにメンバー (プロパティとメソッド) を追加できます。たとえば、オブジェクトの説明を 含む NoteProperty メンバーや 、スクリプトを実行してオブジェクトを変更する ScriptMethod メンバーを追加できます。

使用Add-Memberするには、オブジェクトをパイプ処理するかAdd-Member、InputObject パラメーターを使用してオブジェクトを指定します。

MemberType パラメーターは、追加するメンバーの型を示します。 Name パラメーターは新しいメンバーに名前を割り当て、Value パラメーターはメンバーの値を設定します。

追加するプロパティとメソッドは、指定したオブジェクトの特定のインスタンスにのみ追加されます。 Add-Member では、オブジェクトの種類は変更されません。新しいオブジェクトの種類を作成するには、コマンドレットを Add-Type 使用します。

コマンドレットを Export-Clixml 使用して、追加のメンバーを含むオブジェクトのインスタンスをファイルに保存することもできます。その後、コマンドレットを Import-Clixml 使用して、エクスポートされたファイルに格納されている情報からオブジェクトのインスタンスを再作成できます。

Windows PowerShell 3.0 以降では、 Add-Member オブジェクトにノートプロパティを簡単に追加できる新機能が追加されました。 NotePropertyName パラメーターと NotePropertyValue パラメーターを使用してメモプロパティを定義するか、NotePropertyMembers パラメーターを使用できます。このパラメーターは、メモプロパティの名前と値のハッシュテーブルを受け取ります。

また、Windows PowerShell 3.0 以降では、 出力オブジェクトを生成する PassThru パラメーターが必要になる頻度が低くなります。 Add-Member では、新しいメンバーが、より多くの型の入力オブジェクトに直接追加されるようになりました。詳細については、PassThru パラメーターの説明を参照してください。

例

例 1: PSObject にメモプロパティを追加する

次の使用例は、ファイルを表す FileInfo オブジェクトに、値が "Done" の Status Note プロパティをTest.txt追加します。

最初のコマンドでは、コマンドレットを Get-ChildItem 使用して、ファイルを 表す FileInfo オブジェクトを Test.txt 取得します。変数に $a 保存します。

2 番目のコマンドは、オブジェクトに note プロパティを $a追加します。

3 番目のコマンドは、ドット表記を使用して、オブジェクト$aの Status プロパティの値を取得します。出力が示すように、値は Done.

$A = Get-ChildItem c:\ps-test\test.txt
$A | Add-Member -NotePropertyName Status -NotePropertyValue Done
$A.Status

Done

例 2: PSObject にエイリアスプロパティを追加する

次の例では、ファイルを 表すオブジェクトに Size エイリアスプロパティを Test.txt 追加します。新しいプロパティは、Length プロパティのエイリアスです。

最初のコマンドでは、コマンドレットをGet-ChildItem使用して FileInfo オブジェクトをTest.txt取得します。

2 番目のコマンドは、Size エイリアスプロパティを追加します。 3 番目のコマンドでは、ドット表記を使用して新しい Size プロパティの値を取得します。

$A = Get-ChildItem C:\Temp\test.txt
$A | Add-Member -MemberType AliasProperty -Name Size -Value Length
$A.Size

2394

例 3: StringUse Note プロパティを文字列に追加する

次の使用例は、 StringUse Note プロパティを文字列に追加します。 Add-Member String 入力オブジェクトに型を追加できないため、PassThru パラメーターを指定して出力オブジェクトを生成できます。例の最後のコマンドは、新しいプロパティを表示します。

この例では、 NotePropertyMembers パラメーターを 使用します。 NotePropertyMembers パラメーターの値はハッシュテーブルです。キーはノートプロパティ名 StringUse で、値はノートプロパティの値である Display です。

$A = "A string"
$A = $A | Add-Member -NotePropertyMembers @{StringUse="Display"} -PassThru
$A.StringUse

Display

例 4: FileInfo オブジェクトにスクリプトメソッドを追加する

次の使用例は、SizeIn MB (メガバイト) スクリプトメソッドを FileInfo オブジェクトに追加し、ファイルサイズを最も近い MegaByte に計算します。 2 番目のコマンドは、型から Round 静的メソッドを使用して、ファイルサイズを[math]小数点以下 2 番目の小数点以下に丸める ScriptBlock を作成します。

Value パラメーターは、現在のオブジェクトを$This表す自動変数も使用します。変数は $This 、新しいプロパティとメソッドを定義するスクリプトブロックでのみ有効です。

最後のコマンドでは、ドット表記を使用して、変数内のオブジェクトに対して新しい SizeIn MB (メガバイト) スクリプトメソッドを$A呼び出します。

$A = Get-ChildItem C:\Temp\test.txt
$S = {[math]::Round(($this.Length / 1MB), 2)}
$A | Add-Member -MemberType ScriptMethod -Name "SizeInMB" -Value $S
$A.SizeInMB()

0.43

例 5: カスタムオブジェクトを作成する

この例では、Asset カスタムオブジェクトを作成します。

このコマンドレットは New-Object 、変数に 保存される PSObject を $Asset 作成します。型アクセラレータは [ordered] 、変数に格納されている順序付きディクショナリを $d 作成します。パイプを$Asset使用するとAdd-Member、ディクショナリ内のキーと値のペアが NoteProperty メンバーとしてオブジェクトに追加されます。 TypeName パラメーターは、PSObject に型Assetを割り当てます。このコマンドレットは Get-Member 、オブジェクトの型とプロパティを示します。ただし、プロパティは、追加された順序ではなく、アルファベット順に一覧表示されます。

$Asset = New-Object -TypeName PSObject
$d = [ordered]@{Name="Server30"; System="Server Core"; PSVersion="4.0"}
$Asset | Add-Member -NotePropertyMembers $d -TypeName Asset
$Asset | Get-Member -MemberType Properties

TypeName: Asset

Name        MemberType   Definition
----        ----------   ----------
Name        NoteProperty string Name=Server30
PSVersion   NoteProperty string PSVersion=4.0
System      NoteProperty string System=Server Core

$Asset.PSObject.Properties | Format-Table Name, MemberType, TypeNameOfValue, Value

Name        MemberType TypeNameOfValue Value
----        ---------- --------------- -----
Name      NoteProperty System.String   Server30
System    NoteProperty System.String   Server Core
PSVersion NoteProperty System.String   4.0

プロパティの生の一覧を調べると、プロパティがオブジェクトに追加された順序で表示されます。 Format-Table この例では、次のような出力を作成するために使用します Get-Member。

例 6: AliasProperty をオブジェクトに追加する

この例では、2 つの NoteProperty メンバーを含むカスタムオブジェクトを作成します。 NoteProperty の型は、プロパティに格納されている値の型を反映します。この場合、 Age プロパティは文字列です。

PS> $obj = [pscustomobject]@{
      Name = 'Doris'
      Age = '20'
}
PS> $obj | Add-Member -MemberType AliasProperty -Name 'intAge' -Value age -SecondValue uint32
PS> $obj | Get-Member

   TypeName: System.Management.Automation.PSCustomObject

Name        MemberType    Definition
----        ----------    ----------
intAge      AliasProperty intAge = (System.UInt32)age
Equals      Method        bool Equals(System.Object obj)
GetHashCode Method        int GetHashCode()
GetType     Method        type GetType()
ToString    Method        string ToString()
Age         NoteProperty  string Age=20
Name        NoteProperty  string Name=Doris

PS> $obj

Name  Age intAge
----  --- ------
Doris 20      20

PS> $obj.Age + 1

201

PS> $obj.intAge + 1

21

intAge プロパティは Age プロパティの AliasProperty ですが、型は uint32 であることが保証されます。

例 7: カスタムオブジェクトに get メソッドと set メソッドを追加する

この例では、深く入れ子になったプロパティにアクセスする Get メソッドと Set メソッドを定義する方法を示します。

$user = [pscustomobject]@{
    Name      = 'User1'
    Age       = 29
    StartDate = [datetime]'2019-05-05'
    Position  = [pscustomobject]@{
        DepartmentName = 'IT'
        Role = 'Manager'
    }
}
$addMemberSplat = @{
    MemberType = 'ScriptProperty'
    Name = 'Title'
    Value = { $this.Position.Role }                  # getter
    SecondValue = { $this.Position.Role = $args[0] } # setter
}
$user | Add-Member @addMemberSplat
$user | Get-Member

TypeName: System.Management.Automation.PSCustomObject

Name        MemberType     Definition
----        ----------     ----------
Equals      Method         bool Equals(System.Object obj)
GetHashCode Method         int GetHashCode()
GetType     Method         type GetType()
ToString    Method         string ToString()
Age         NoteProperty   int Age=29
Name        NoteProperty   string Name=User1
Position    NoteProperty   System.Management.Automation.PSCustomObject Position=@{DepartmentName=IT; Role=Manager}
StartDate   NoteProperty   datetime StartDate=5/5/2019 12:00:00 AM
Title       ScriptProperty System.Object Title {get= $this.Position.Role ;set= $this.Position.Role = $args[0] ;}

$user.Title = 'Dev Manager'

Name      : User1
Age       : 29
StartDate : 5/5/2019 12:00:00 AM
Position  : @{DepartmentName=IT; Role=Dev Manager}
Title     : Dev Manager

Title プロパティは、Get メソッドと Set メソッドを持つ ScriptProperty であることに注意してください。 Title プロパティに新しい値を割り当てると、Set メソッドが呼び出され、Position プロパティの Role プロパティの値が変更されます。

パラメーター

-Force

既定では、 Add-Member オブジェクトに同じメンバーが既に存在する場合は、新しいメンバーを追加できません。 Force パラメーターを使用する場合は、Add-Member既存のメンバーを新しいメンバーに置き換えます。 Force パラメーターを使用して、型の標準メンバーを置き換えることはできません。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

新しいメンバーを追加するオブジェクトを指定します。オブジェクトが格納されている変数を入力するか、オブジェクトを取得するコマンドまたは式を入力します。

Type:	PSObject
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-MemberType

追加するメンバーの型を指定します。このパラメーターは必須です。このパラメーターの有効値は、次のとおりです。

AliasProperty
CodeMethod
CodeProperty
NoteProperty
ScriptMethod
ScriptProperty

これらの値の詳細については、PowerShell SDK の PSMemberTypes 列挙型を参照してください。

すべてのオブジェクトにすべての型のメンバーがあるわけではありません。オブジェクトに含まれていないメンバー型を指定すると、PowerShell はエラーを返します。

Type:	PSMemberTypes
Aliases:	Type
Accepted values:	AliasProperty, CodeMethod, CodeProperty, NoteProperty, ScriptMethod, ScriptProperty
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

このコマンドレットが追加するメンバーの名前を指定します。

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NotePropertyMembers

NoteProperty 名とその値を表すキーと値のペアを含むハッシュテーブルまたは順序付きディクショナリを指定します。 PowerShell でのハッシュテーブルと順序付きディクショナリの詳細については、「about_Hash_Tables」を参照してください。

このパラメーターは Windows PowerShell 3.0 で導入されました。

Type:	IDictionary
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NotePropertyName

メモプロパティ名を指定します。

このパラメーターは NotePropertyValue パラメーターと共に使用します。このパラメーターは省略可能です。

このパラメーターは Windows PowerShell 3.0 で導入されました。

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NotePropertyValue

メモプロパティの値を指定します。

このパラメーターは NotePropertyName パラメーターと共に使用します。このパラメーターは省略可能です。

このパラメーターは Windows PowerShell 3.0 で導入されました。

Type:	Object
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

作業中の項目を表すオブジェクトを返します。既定では、このコマンドレットは出力を生成しません。

ほとんどのオブジェクトでは、 Add-Member 新しいメンバーを入力オブジェクトに追加します。ただし、入力オブジェクトが文字列の場合、 Add-Member メンバーを入力オブジェクトに追加することはできません。これらのオブジェクトの場合は、PassThru パラメーターを使用して出力オブジェクトを作成します。

Windows PowerShell 2.0 では、 Add-Member オブジェクトではなく、オブジェクトの PSObject ラッパーにのみメンバーを追加しました。 PsObject ラッパーを 持つオブジェクトの出力オブジェクトを作成するには、PassThru パラメーターを使用します。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SecondValue

AliasProperty、ScriptProperty、または CodeProperty メンバーに関するオプションの追加情報を指定します。

AliasProperty を追加するときに使用する場合、このパラメーターはデータ型である必要があります。指定したデータ型への変換が AliasProperty の値に追加されます。たとえば、文字列プロパティの代替名を提供する AliasProperty を追加する場合は、System.Int32 の SecondValue パラメーターを指定して、対応する AliasProperty を使用してアクセスするときに、その文字列プロパティの値を整数に変換する必要があることを示すこともできます。

CodeProperty の場合、値は Set アクセサーを実装するメソッドへの参照である必要があります。型参照の GetMethod() メソッドを使用して、メソッドへの参照を取得します。このメソッドは、PSObject である単一のパラメーターを受け取る必要があります。 Get アクセサーは、Value パラメーターを使用して割り当てられます。

ScriptProperty の場合、値は Set アクセサーを実装するスクリプトブロックである必要があります。 Get アクセサーは、Value パラメーターを使用して割り当てられます。

Type:	Object
Position:	3
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TypeName

型の名前を指定します。

型が System 名前空間のクラスまたは型アクセラレータを持つ型である場合は、型の短い名前を入力できます。それ以外の場合は、完全な型名が必要です。このパラメーターは、InputObject が PSObject の場合にのみ有効です。

このパラメーターは Windows PowerShell 3.0 で導入されました。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Value

追加されたメンバーの初期値を指定します。 AliasProperty、CodeProperty、または ScriptProperty メンバーを追加する場合は、SecondValue パラメーターを使用して追加情報を指定できます。

AliasProperty の場合、値はエイリアス化されるプロパティの名前である必要があります。
CodeMethod の場合、値はメソッドへの参照である必要があります。型参照の GetMethod() メソッドを使用して、メソッドへの参照を取得します。
CodeProperty の場合、値は Get アクセサーを実装するメソッドへの参照である必要があります。型参照の GetMethod() メソッドを使用して、メソッドへの参照を取得します。参照。このメソッドは、PSObject である単一のパラメーターを受け取る必要があります。 Set アクセサーは SecondValue パラメーターを使用して割り当てられます。
ScriptMethod の場合、値はスクリプトブロックである必要があります。
ScriptProperty の場合、値は Get アクセサーを実装するスクリプトブロックである必要があります。 Set アクセサーは SecondValue パラメーターを使用して割り当てられます。

Type:	Object
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

入力

PSObject

任意のオブジェクトをこのコマンドレットにパイプできます。

出力

None

既定では、このコマンドレットは出力を返しません。

Object

PassThru パラメーターを使用すると、このコマンドレットは新しく拡張されたオブジェクトを返します。

メモ

メンバーは PSObject 型オブジェクトにのみ追加できます。オブジェクトが PSObject オブジェクトかどうかを確認するには、演算子を -is 使用します。たとえば、変数に格納されている $obj オブジェクトをテストするには、「.」と入力します $obj -is [psobject]。

PSObject 型のオブジェクトメインメンバーがオブジェクトに追加された順序でメンバーのリストが含まれます。

MemberType、Name、Value、SecondValue の各パラメーターの名前は省略可能です。 パラメーター名を省略した場合、名前のないパラメーター値は、MemberType、Name、Value、SecondValue の順に指定する必要があります。

パラメーター名を指定する場合は、パラメーターの順序に決まりはありません。

スクリプトブロックでは、 $this 新しいプロパティとメソッドの値を定義する自動変数を使用できます。変数は $this 、プロパティとメソッドが追加されるオブジェクトのインスタンスを参照します。変数の詳細については$this、about_Automatic_Variablesを参照してください。

Add-Member

構文

説明

例

例 1: PSObject にメモプロパティを追加する

例 2: PSObject にエイリアスプロパティを追加する

例 3: StringUse Note プロパティを文字列に追加する

例 4: FileInfo オブジェクトにスクリプトメソッドを追加する

例 5: カスタムオブジェクトを作成する

例 6: AliasProperty をオブジェクトに追加する

例 7: カスタムオブジェクトに get メソッドと set メソッドを追加する

パラメーター

-Force

-InputObject

-MemberType

-Name

-NotePropertyMembers

-NotePropertyName

-NotePropertyValue

-PassThru

-SecondValue

-TypeName

-Value

入力

出力

メモ

フィードバック

その他のリソース

Add-Member

構文

説明

例

例 1: PSObject にメモ プロパティを追加する

例 2: PSObject にエイリアス プロパティを追加する

例 3: StringUse Note プロパティを文字列に追加する

例 4: FileInfo オブジェクトにスクリプト メソッドを追加する

例 5: カスタム オブジェクトを作成する

例 6: AliasProperty をオブジェクトに追加する

例 7: カスタム オブジェクトに get メソッドと set メソッドを追加する

パラメーター

-Force

-InputObject

-MemberType

-Name

-NotePropertyMembers

-NotePropertyName

-NotePropertyValue

-PassThru

-SecondValue

-TypeName

-Value

入力

出力

メモ

関連リンク

フィードバック

その他のリソース

例 1: PSObject にメモプロパティを追加する

例 2: PSObject にエイリアスプロパティを追加する

例 4: FileInfo オブジェクトにスクリプトメソッドを追加する

例 5: カスタムオブジェクトを作成する

例 7: カスタムオブジェクトに get メソッドと set メソッドを追加する