Add-Member
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
$Asset | Add-Member -NotePropertyMembers @{Name="Server30"} -TypeName Asset
$Asset | Add-Member -NotePropertyMembers @{System="Server Core"}
$Asset | Add-Member -NotePropertyMembers @{PSVersion="4.0"}
$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 : Doris
Age : 20
intAge : 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 |
入力
任意のオブジェクトをこのコマンドレットにパイプできます。
出力
None
既定では、このコマンドレットは出力を返しません。
PassThru パラメーターを使用すると、このコマンドレットは新しく拡張されたオブジェクトを返します。
メモ
メンバーは PSObject 型オブジェクトにのみ追加できます。 オブジェクトが PSObject オブジェクトかどうかを確認するには、演算子を -is
使用します。 たとえば、変数に格納されている $obj
オブジェクトをテストするには、「.」と入力します $obj -is [psobject]
。
PSObject 型のオブジェクトメインメンバーがオブジェクトに追加された順序でメンバーのリストが含まれます。
MemberType、Name、Value、SecondValue の各パラメーターの名前は省略可能です。 パラメーター名を省略した場合、名前のないパラメーター値は、MemberType、Name、Value、SecondValue の順に指定する必要があります。
パラメーター名を指定する場合は、パラメーターの順序に決まりはありません。
スクリプト ブロックでは、 $this
新しいプロパティとメソッドの値を定義する自動変数を使用できます。 変数は $this
、プロパティとメソッドが追加されるオブジェクトのインスタンスを参照します。 変数の詳細については$this
、about_Automatic_Variablesを参照してください。
関連リンク
PowerShell
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示