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 パラメーターを使用します。

Get-Member は、アルファベット順に並べ替えられたメンバーの一覧を返します。メソッドが最初に一覧表示され、その後にプロパティが続きます。

例

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

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

この例では、ファイルまたはコマンドレットを使用して Types.ps1xml 拡張されたサービスオブジェクトのメソッドとプロパティを Add-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-Member、View パラメーターを使用して、サービスオブジェクトの拡張メンバーのみを取得します。この場合、拡張メンバーは、ServiceName プロパティのエイリアスプロパティである Name プロパティです。

例 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 パラメーターは、MachineName という名前のメンバーに結果Get-Memberを制限します。

$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 Int32オブジェクトと文字列オブジェクトが含まれています。配列のパイプ先として表示されますGet-Member。 InputObject パラメーターを使用して渡されると、Object[] 型のメンバーが返されます。Get-Member$array

例 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

例 8: オブジェクトのプロパティを作成順に一覧表示する

この例では、新 しい PSObject を 作成し、それにプロパティを追加します。 Get-Member は、プロパティをアルファベット順に一覧表示します。プロパティがオブジェクトに追加された順序で表示するには、PSObject 組み込みメンバーを使用する必要があります。

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

Name      Value
----      -----
Name      Server30
System    Server Core
PSVersion 4.0

パラメーター

-Force

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

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

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

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

-InputObject

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

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

オブジェクト Get-Memberのコレクションをパイプ処理する場合は、 Get-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 パラメーターに渡すことができます。コマンドレットは、バイナリ 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すべてのパラメーターの条件を満たすメンバーのみを取得します。

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

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

-Static

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

View パラメーターまたは Force パラメーターで Static パラメーターを使用する場合、コマンドレットはこれらのパラメーターを無視します。 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

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

出力

MemberDefinition

このコマンドレットは、取得する 各プロパティまたはメソッドの MemberDefinition を返します。

メモ

PowerShell には、次のエイリアスが Get-Member含まれています。

すべてのプラットフォーム:
- gm

コレクションオブジェクトに関する情報を取得するには、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: 設定できるオブジェクト・プロパティーを判別する

例 8: オブジェクトのプロパティを作成順に一覧表示する

パラメーター

-Force

-InputObject

-MemberType

-Name

-Static

-View

入力

出力

メモ

フィードバック

その他のリソース

Get-Member

構文

説明

例

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

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

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

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

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

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

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

例 8: オブジェクトのプロパティを作成順に一覧表示する

パラメーター

-Force

-InputObject

-MemberType

-Name

-Static

-View

入力

出力

メモ

関連リンク

フィードバック

その他のリソース

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

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

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

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