Get-Member

リファレンス

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

オブジェクトのプロパティとメソッドを取得します。

構文

Get-Member
   [-InputObject <PSObject>]
   [[-Name] <String[]>]
   [-MemberType <PSMemberTypes>]
   [-View <PSMemberViewTypes>]
   [-Static]
   [-Force]
   [<CommonParameters>]

説明

コマンドレットは Get-Member 、オブジェクトのメンバー、プロパティ、およびメソッドを取得します。

オブジェクトを指定するには、 InputObject パラメーターを使用するか、オブジェクトをに Get-Memberパイプします。静的メンバーに関する情報を取得するには、インスタンスではなくクラスのメンバーが Static パラメーターを使用します。 NoteProperties など、特定の種類のメンバーのみを取得するには、MemberType パラメーターを使用します。

例

例 1: プロセスオブジェクトのメンバーを取得する

このコマンドは、コマンドレットによって生成されたサービスオブジェクトのプロパティとメソッドを Get-Service 表示します。

コマンドの Get-Member 一部にはパラメーターがないため、パラメーターには既定値が使用されます。既定では、 Get-Member は静的メンバーまたは組み込みメンバーを取得しません。

Get-Service | Get-Member

TypeName: System.Service.ServiceController#StartupType

Name                      MemberType    Definition
----                      ----------    ----------
Name                      AliasProperty Name = ServiceName
RequiredServices          AliasProperty RequiredServices = ServicesDependedOn
Disposed                  Event         System.EventHandler Disposed(System.Object, System.EventArgs)
Close                     Method        void Close()
Continue                  Method        void Continue()
Dispose                   Method        void Dispose(), void IDisposable.Dispose()
Equals                    Method        bool Equals(System.Object obj)
ExecuteCommand            Method        void ExecuteCommand(int command)
GetHashCode               Method        int GetHashCode()
GetLifetimeService        Method        System.Object GetLifetimeService()
GetType                   Method        type GetType()
InitializeLifetimeService Method        System.Object InitializeLifetimeService()
Pause                     Method        void Pause()
Refresh                   Method        void Refresh()
Start                     Method        void Start(), void Start(string[] args)
Stop                      Method        void Stop()
WaitForStatus             Method        void WaitForStatus(System.ServiceProcess.ServiceControllerSt...
BinaryPathName            Property      System.String {get;set;}
CanPauseAndContinue       Property      bool CanPauseAndContinue {get;}
CanShutdown               Property      bool CanShutdown {get;}
CanStop                   Property      bool CanStop {get;}
Container                 Property      System.ComponentModel.IContainer Container {get;}
DelayedAutoStart          Property      System.Boolean {get;set;}
DependentServices         Property      System.ServiceProcess.ServiceController[] DependentServices {get;}
Description               Property      System.String {get;set;}
DisplayName               Property      string DisplayName {get;set;}
MachineName               Property      string MachineName {get;set;}
ServiceHandle             Property      System.Runtime.InteropServices.SafeHandle ServiceHandle {get;}
ServiceName               Property      string ServiceName {get;set;}
ServicesDependedOn        Property      System.ServiceProcess.ServiceController[] ServicesDependedOn {get;}
ServiceType               Property      System.ServiceProcess.ServiceType ServiceType {get;}
Site                      Property      System.ComponentModel.ISite Site {get;set;}
StartType                 Property      System.ServiceProcess.ServiceStartMode StartType {get;}
StartupType               Property      Microsoft.PowerShell.Commands.ServiceStartupType {get;set;}
Status                    Property      System.ServiceProcess.ServiceControllerStatus Status {get;}
UserName                  Property      System.String {get;set;}
ToString                  ScriptMethod  System.Object ToString();

例 2: サービスオブジェクトのメンバーを取得する

この例では、PSBase、PSObject、get_ メソッド、set_ メソッドなどの組み込みメンバーを含め、コマンドレットによってGet-Service取得されるサービスオブジェクトのすべてのメンバー (プロパティとメソッド) を取得します。

Get-Service | Get-Member -Force
(Get-Service Schedule).PSBase

コマンドは Get-MemberForce パラメーターを使用して、オブジェクトの組み込みメンバーとコンパイラによって生成されたメンバーをディスプレイに追加します。これらのプロパティとメソッドは、オブジェクトのアダプター適用対象のメソッドを使用する場合と同じ方法で使用できます。 2 番目のコマンドは、Schedule サービスの PSBase プロパティの値を表示する方法を示しています。組み込みメンバーの詳細については、「スケジュールサービス about_Intrinsic_MembersPSBase プロパティの値を表示する」を参照してください。組み込みメンバーの詳細については、「about_Intrinsic_Members」を参照してください。

例 3: サービスオブジェクトの拡張メンバーを取得する

この例では、ファイルまたはコマンドレットを使用して拡張されたサービスオブジェクトのメソッドとプロパティをTypes.ps1xmlAdd-Member取得します。

Get-Service | Get-Member -View Extended

TypeName: System.Service.ServiceController#StartupType

Name             MemberType    Definition
----             ----------    ----------
Name             AliasProperty Name = ServiceName
RequiredServices AliasProperty RequiredServices = ServicesDependedOn
ToString         ScriptMethod  System.Object ToString();

コマンドは Get-MemberView パラメーターを使用して、サービスオブジェクトの拡張メンバーのみを取得します。この場合、拡張メンバーは Name プロパティで、 ServiceName プロパティのエイリアスプロパティです。

例 4: イベントログオブジェクトのスクリプトプロパティを取得する

次の使用例は、イベントビューアーのシステムログ内のイベントログオブジェクトのスクリプトプロパティを取得します。

Get-WinEvent -LogName System -MaxEvents 1 | Get-Member -MemberType NoteProperty

TypeName: System.Diagnostics.Eventing.Reader.EventLogRecord

Name    MemberType   Definition
----    ----------   ----------
Message NoteProperty string Message=The machine-default permission settings do not grant Local ...

MemberType パラメーターは、MemberType プロパティの値がのNotePropertyオブジェクトのみを取得します。

コマンドは、EventLogRecord オブジェクトの Message プロパティを返します。

例 5: 指定したプロパティを持つオブジェクトを取得する

この例では、コマンドレットの一覧から出力に MachineName プロパティを持つオブジェクトを取得します。

変数には $list 、評価するコマンドレットの一覧が含まれています。 foreach ステートメントは各コマンドを呼び出し、結果をにGet-Member送信します。 Name パラメーターは、のGet-Member結果を MachineName という名前のメンバーに制限します。

$list = "Get-Process", "Get-Service", "Get-Culture", "Get-PSDrive", "Get-ExecutionPolicy"
foreach ($cmdlet in $list) {& $cmdlet | Get-Member -Name MachineName}

TypeName: System.Diagnostics.Process

Name        MemberType Definition
----        ---------- ----------
MachineName Property   string MachineName {get;}

   TypeName: System.Service.ServiceController#StartupType

Name        MemberType Definition
----        ---------- ----------
MachineName Property   string MachineName {get;set;}

結果は、プロセスオブジェクトとサービスオブジェクトのみが MachineName プロパティを持っていることを示しています。

例 6: 配列のメンバーを取得する

この例では、オブジェクトの配列のメンバーを検索する方法を示します。オブジェクトの配列をに Get-Memberパイプ処理すると、コマンドレットは配列内の一意のオブジェクト型ごとにメンバーリストを返します。 InputObject パラメーターを使用して配列を渡すと、配列は 1 つのオブジェクトとして扱われます。

$array = @(1,'hello')
$array | Get-Member

TypeName: System.Int32

Name        MemberType Definition
----        ---------- ----------
CompareTo   Method     int CompareTo(System.Object value), int CompareTo(int value), int ICompar...
Equals      Method     bool Equals(System.Object obj), bool Equals(int obj), bool IEquatable[int...
GetHashCode Method     int GetHashCode()
GetType     Method     type GetType()
GetTypeCode Method     System.TypeCode GetTypeCode(), System.TypeCode IConvertible.GetTypeCode()
ToBoolean   Method     bool IConvertible.ToBoolean(System.IFormatProvider provider)
ToByte      Method     byte IConvertible.ToByte(System.IFormatProvider provider)
...

   TypeName: System.String

Name                 MemberType            Definition
----                 ----------            ----------
Clone                Method                System.Object Clone(), System.Object ICloneable.Clone()
CompareTo            Method                int CompareTo(System.Object value), int CompareTo(str...
Contains             Method                bool Contains(string value), bool Contains(string val...
CopyTo               Method                void CopyTo(int sourceIndex, char[] destination, int ...
EndsWith             Method                bool EndsWith(string value), bool EndsWith(string val...
EnumerateRunes       Method                System.Text.StringRuneEnumerator EnumerateRunes()
Equals               Method                bool Equals(System.Object obj), bool Equals(string va...
GetEnumerator        Method                System.CharEnumerator GetEnumerator(), System.Collect...
GetHashCode          Method                int GetHashCode(), int GetHashCode(System.StringCompa...
...

Get-Member -InputObject $array

TypeName: System.Object[]

Name           MemberType            Definition
----           ----------            ----------
Add            Method                int IList.Add(System.Object value)
Address        Method                System.Object&, System.Private.CoreLib, Version=4.0.0.0, Cu...
Clear          Method                void IList.Clear()
Clone          Method                System.Object Clone(), System.Object ICloneable.Clone()
CompareTo      Method                int IStructuralComparable.CompareTo(System.Object other, Sy...
...

変数には$array、配列がにGet-Memberパイプされるときに表示される Int32 オブジェクトと文字列オブジェクトが含まれます。 $arrayが InputObject パラメーターGet-Memberを使用して渡されると、Object[] 型のメンバーが返されます。

例 7: 設定できるオブジェクトプロパティを決定する

この例は、オブジェクトのどのプロパティを変更できるかを判断する方法を示します。

$File = Get-Item c:\test\textFile.txt
$File.PSObject.Properties | Where-Object isSettable | Select-Object -Property Name

Name
----
PSPath
PSParentPath
PSChildName
PSDrive
PSProvider
PSIsContainer
IsReadOnly
CreationTime
CreationTimeUtc
LastAccessTime
LastAccessTimeUtc
LastWriteTime
LastWriteTimeUtc
Attributes

パラメーター

-Force

組み込みメンバーとコンパイラによって生成された get_ メソッドと set_ メソッドをディスプレイに追加します。次の一覧では、 Force パラメーターを使用するときに追加されるプロパティについて説明します。

PSBase: 拡張子や適応のない .NET オブジェクトの元のプロパティ。これらは、オブジェクトクラスに対して定義されているプロパティです。
PSAdapted: PowerShell 拡張型システムで定義されているプロパティとメソッド。
PSExtended: ファイルまたはコマンドレットを使用してAdd-Member追加Types.ps1xmlされたプロパティとメソッド。
PSObject: 基本オブジェクトを PowerShell PSObject オブジェクトに変換するアダプター。
PSTypeNames: 特定の順序でオブジェクトを記述するオブジェクト型の一覧。オブジェクトを書式設定すると、PowerShell は PowerShell インストールディレクトリ ($PSHOME) 内のFormat.ps1xmlファイル内の型を検索します。検出した最初の型の書式設定定義を使用します。

既定では、 Get-MemberBase と Adapted を除くすべてのビューでこれらのプロパティを取得しますが、表示されません。

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

-InputObject

取得するメンバーを含んでいるオブジェクトを指定します。

InputObject パラメーターの使用は、オブジェクトをにGet-Memberパイプするのと同じではありません。相違点は、次のとおりです。

オブジェクトのコレクションをにGet-MemberGet-Memberパイプ処理すると、コレクション内の個々のオブジェクトのメンバー (文字列の配列内の各文字列のプロパティなど) が取得されます。
InputObject を使用してオブジェクトのコレクションを送信する場合は、Get-Member文字列の配列内の配列のプロパティなど、コレクションのメンバーを取得します。

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

-MemberType

このコマンドレットが取得するメンバーの種類を指定します。既定値は、All です。

このパラメーターの有効値は、次のとおりです。

AliasProperty
CodeProperty
Property
NoteProperty
ScriptProperty
Properties
PropertySet
Method
CodeMethod
ScriptMethod
Methods
ParameterizedProperty
MemberSet
Event
Dynamic
All

これらの値は、フラグベースの列挙体として定義されます。複数の値を組み合わせて、このパラメーターを使用して複数のフラグを設定できます。値は、値の配列として、またはそれらの値のコンマ区切りの文字列として MemberType パラメーターに渡すことができます。コマンドレットは、binary-OR 操作を使用して値を結合します。配列として値を渡すことは最も簡単なオプションであり、値にタブ補完を使用することもできます。

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

すべてのオブジェクトにすべての型のメンバーがあるわけではありません。オブジェクトに含まれていないメンバー型を指定すると、PowerShell は null 値を返します。すべての拡張メンバーなど、関連する型のメンバーを取得するには、View パラメーターを使用します。 MemberType パラメーターを Static パラメーターまたは View パラメーターと共に使用する場合は、Get-Member両方のセットに属するメンバーを取得します。

Type:	PSMemberTypes
Aliases:	Type
Accepted values:	AliasProperty, CodeProperty, Property, NoteProperty, ScriptProperty, Properties, PropertySet, Method, CodeMethod, ScriptMethod, Methods, ParameterizedProperty, MemberSet, Event, Dynamic, All
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

オブジェクトの 1 つまたは複数のプロパティまたはメソッドの名前を指定します。 Get-Member は、指定されたプロパティとメソッドのみを取得します。

MemberType、View、または Static パラメーターで Name パラメーターを使用する場合は、Get-Memberすべてのパラメーターの条件を満たすメンバーのみを取得します。

静的メンバーを名前で取得するには、 Static パラメーターと Name パラメーターを使用します。

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

-Static

このコマンドレットは、オブジェクトの静的プロパティとメソッドのみを取得することを示します。静的プロパティおよびメソッドは、クラスの特定のインスタンスで定義されるのではなく、オブジェクトのクラスで定義されます。

View パラメーターで Static パラメーターを使用する場合、View パラメーターは無視されます。 MemberType パラメーターで Static パラメーターを使用する場合は、Get-Member両方のセットに属するメンバーのみを取得します。

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

-View

このコマンドレットが特定の型のプロパティとメソッドのみを取得することを指定します。 1 つまたは複数の値を指定します。既定値は Adapted、 Extended です。

このパラメーターの有効値は、次のとおりです。

底。 .NET オブジェクトの元のプロパティとメソッドのみを取得します (拡張または適応なし)。
適応。 PowerShell 拡張型システムで定義されているプロパティとメソッドのみを取得します。
拡張。ファイルまたはコマンドレットを使用してAdd-Member追加Types.ps1xmlされたプロパティとメソッドのみを取得します。
すべて。 Base、Adapted、および Extended ビューのメンバーを取得します。

View パラメーターは、それらのメンバーの表示だけでなく、取得されたメンバーを決定します。

スクリプトプロパティなどの特定のメンバー型を取得するには、 MemberType パラメーターを使用します。同じコマンドで MemberType パラメーターと View パラメーターを使用する場合は、 Get-Member 両方のセットに属するメンバーを取得します。同じコマンドで Static パラメーターと View パラメーターを使用する場合、 View パラメーターは無視されます。

Type:	PSMemberViewTypes
Accepted values:	Extended, Adapted, Base, All
Position:	Named
Default value:	Adapted, Extended
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

入力

PSObject

任意のオブジェクトをに Get-Memberパイプできます。

出力

MemberDefinition

Get-Member は、取得する各プロパティまたはメソッドのオブジェクトを返します。

メモ

コレクションオブジェクトに関する情報を取得するには、 InputObject パラメーターを使用するか、オブジェクトの前にコンマを付けてをに Get-Memberパイプします。

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

などの[int]Get-Member型リテラルのような型を表すオブジェクトを渡すと、型に関する情報が[System.RuntimeType]返されます。ただし、 Static パラメーターを使用すると、 Get-Member インスタンスによって表される特定の型の静的メンバーが System.RuntimeType 返されます。

Add-Member

次の方法で共有

Get-Member

構文

説明

例

例 1: プロセスオブジェクトのメンバーを取得する

例 2: サービスオブジェクトのメンバーを取得する

例 3: サービスオブジェクトの拡張メンバーを取得する

例 4: イベントログオブジェクトのスクリプトプロパティを取得する

例 5: 指定したプロパティを持つオブジェクトを取得する

例 6: 配列のメンバーを取得する

例 7: 設定できるオブジェクトプロパティを決定する

パラメーター

-Force

-InputObject

-MemberType

-Name

-Static

-View

入力

出力

メモ

その他のリソース

次の方法で共有

Get-Member

構文

説明

例

例 1: プロセス オブジェクトのメンバーを取得する

例 2: サービス オブジェクトのメンバーを取得する

例 3: サービス オブジェクトの拡張メンバーを取得する

例 4: イベント ログ オブジェクトのスクリプト プロパティを取得する

例 5: 指定したプロパティを持つオブジェクトを取得する

例 6: 配列のメンバーを取得する

例 7: 設定できるオブジェクト プロパティを決定する

パラメーター

-Force

-InputObject

-MemberType

-Name

-Static

-View

入力

出力

メモ

関連リンク

その他のリソース

例 1: プロセスオブジェクトのメンバーを取得する

例 2: サービスオブジェクトのメンバーを取得する

例 3: サービスオブジェクトの拡張メンバーを取得する

例 4: イベントログオブジェクトのスクリプトプロパティを取得する

例 7: 設定できるオブジェクトプロパティを決定する