< Back
Get-Member
Post
NAME Get-Member
SYNOPSIS
Gets the properties and methods of objects.
SYNTAX
Get-Member [[-Name] <String[]>] [-Force] [-InputObject <PSObject>] [-MemberType {AliasProperty | CodeProperty | Property | NoteProperty |
ScriptProperty | Properties | PropertySet | Method | CodeMethod | ScriptMethod | Methods | ParameterizedProperty | MemberSet | Event | Dynamic |
All}] [-Static] [-View {Extended | Adapted | Base | All}] [<CommonParameters>]
DESCRIPTION
The Get-Member cmdlet gets the members, the properties and methods, of objects.
To specify the object, use the InputObject parameter or pipe an object to Get-Member . To get information about static members, the members of the
class, not of the instance, use the Static parameter. To get only certain types of members, such as NoteProperties , use the MemberType parameter.
PARAMETERS
-Force [<SwitchParameter>]
Adds the intrinsic members (PSBase, PSAdapted, PSObject, PSTypeNames) and the compiler-generated get_ and set_ methods to the display. By
default, Get-Member gets these properties in all views other than Base and Adapted, but it does not display them.
The following list describes the properties that are added when you use the Force parameter:
- PSBase: The original properties of the .NET Framework object without extension or adaptation. These are the properties defined for the
object class and listed in MSDN.
- PSAdapted. The properties and methods defined in the Windows PowerShell extended type system.
- PSExtended. The properties and methods that were added in the Types.ps1xml files or by using the Add-Member cmdlet.
- PSObject. The adapter that converts the base object to a Windows PowerShell PSObject object. - PSTypeNames. A list of object types that
describe the object, in order of specificity. When formatting the object, Windows PowerShell searches for the types in the Format.ps1xml files
in the Windows PowerShell installation directory ($pshome). It uses the formatting definition for the first type that it finds.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-InputObject <PSObject>
Specifies the object whose members are retrieved.
Using the InputObject parameter is not the same as piping an object to Get-Member . The differences are as follows:
- When you pipe a collection of objects to Get-Member , Get-Member gets the members of the individual objects in the collection, such as the
properties of each string in an array of strings. - When you use InputObject to submit a collection of objects, Get-Member gets the members of
the collection, such as the properties of the array in an array of strings.
Required? false
Position? named
Default value None
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-MemberType <PSMemberTypes>
Specifies the member type that this cmdlet gets. The default is All.
The acceptable values for this parameter are:
- AliasProperty
- CodeProperty
- Property
- NoteProperty
- ScriptProperty
- Properties
- PropertySet
- Method
- CodeMethod
- ScriptMethod
- Methods
- ParameterizedProperty
- MemberSet
- Event
- Dynamic
- All
For information about these values, see PSMemberTypes
Enumeration"https://msdn.microsoft.com/en-us/librar ... s.85).aspx
(https://msdn.microsoft.com/en-us/librar ... s.85).aspx ) in MSDN.
Not all objects have every type of member. If you specify a member type that the object does not have, Windows PowerShell returns a null value.
To get related types of members, such as all extended members, use the View parameter. If you use the MemberType parameter with the Static or
View parameters, Get-Member gets the members that belong to both sets.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Name <String[]>
Specifies the names of one or more properties or methods of the object. Get-Member gets only the specified properties and methods.
If you use the Name parameter with the MemberType , View , or Static parameter, Get-Member gets only the members that satisfy the criteria of
all parameters.
To get a static member by name, use the Static parameter with the Name parameter.
Required? false
Position? 0
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Static [<SwitchParameter>]
Indicates that this cmdlet gets only the static properties and methods of the object.
Static properties and methods are defined on the class of objects, not on any particular instance of the class.
If you use the Static parameter with the View parameter, the View parameter is ignored. If you use the Static parameter with the MemberType
parameter, Get-Member gets only the members that belong to both sets.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-View <PSMemberViewTypes>
Specifies that this cmdlet gets only particular types properties and methods. Specify one or more of the values. The default is Adapted,
Extended.
The acceptable values for this parameter are:
- Base. Gets only the original properties and methods of the .NET Framework object (without extension or adaptation).
- Adapted. Gets only the properties and methods defined in the Windows PowerShell extended type system.
- Extended. Gets only the properties and methods that were added in the Types.ps1xml files or by using the Add-Member cmdlet.
- All. Gets the members in the Base, Adapted, and Extended views.
The View parameter determines the members retrieved, not just the display of those members.
To get particular member types, such as script properties, use the MemberType parameter. If you use the MemberType and View parameters in the
same command, Get-Member gets the members that belong to both sets. If you use the Static and View parameters in the same command, the View
parameter is ignored.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
System.Management.Automation.PSObject
You can pipe any object to Get-Member .
OUTPUTS
Microsoft.PowerShell.Commands.MemberDefinition
Get-Member returns an object for each property or method that its gets.
NOTES
You can get information about a collection object either by using the InputObject parameter or by piping the object, preceded by a comma, to
Get-Member *.
You can use the $This automatic variable in script blocks that define the values of new properties and methods. The $This variable refers to
the instance of the object to which the properties and methods are being added. For more information about the $This variable, see
about_Automatic_Variables.
*
Example 1: Get the members of process objects
PS C:\\>Get-Service | Get-Member
TypeName: System.ServiceProcess.ServiceController
Name MemberType Definition
---- ---------- ----------
Name AliasProperty Name = ServiceName
Close Method System.Void Close()
Continue Method System.Void Continue()
CreateObjRef Method System.Runtime.Remoting.ObjRef CreateObjRef(Type requestedType)
Dispose Method System.Void Dispose()
Equals Method System.Boolean Equals(Object obj)
ExecuteCommand Method System.Void ExecuteCommand(Int32 command)
GetHashCode Method System.Int32 GetHashCode()
GetLifetimeService Method System.Object GetLifetimeService()
GetType Method System.Type GetType()
InitializeLifetimeService Method System.Object InitializeLifetimeService()
Pause Method System.Void Pause()
Refresh Method System.Void Refresh()
Start Method System.Void Start(), System.Void Start(String[] args)
Stop Method System.Void Stop()
ToString Method System.String ToString()
WaitForStatus Method System.Void WaitForStatus(ServiceControllerStatus desiredStatus), System.Voi...
CanPauseAndContinue Property System.Boolean CanPauseAndContinue {get;}
CanShutdown Property System.Boolean CanShutdown {get;}
CanStop Property System.Boolean CanStop {get;}
Container Property System.ComponentModel.IContainer Container {get;}
DependentServices Property System.ServiceProcess.ServiceController[] DependentServices {get;}
DisplayName Property System.String DisplayName {get;set;}
MachineName Property System.String MachineName {get;set;}
ServiceHandle Property System.Runtime.InteropServices.SafeHandle ServiceHandle {get;}
ServiceName Property System.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;}
Status Property System.ServiceProcess.ServiceControllerStatus Status {get;}
This command displays the properties and methods of the process objects (System.ServiceProcess.ServiceController) that are generated by the
Get-Service cmdlet.
The command uses the pipeline operator (|) to send the output of a Get-Service command to Get-Member .
Because the Get-Member part of the command does not have any parameters, it uses all of the default values. As such, it gets all member types, but
it does not get static members and does not display intrinsic members.
Example 2: Get members of service objects
PS C:\\>Get-Service | Get-Member -Force
PS C:\\> (Get-Service -Schedule).PSBase
This example gets all of the members (properties and methods) of the service objects (System.ServiceProcess.ServiceController) retrieved by the
Get-Service cmdlet, including the intrinsic members, such as PSBase and PSObject, and the get_ and set_ methods.
The first command uses the Get-Service cmdlet to get objects that represent the services on the system. It uses a pipeline operator (|) to pass
the service objects to the Get-Member cmdlet.
The Get-Member command uses the Force parameter to add the intrinsic members and compiler-generated members of the objects to the display.
Get-Member gets these members, but it hides them by default.
You can use these properties and methods in the same way that you would use an adapted method of the object. The second command shows how to
display the value of the PSBase property of the Schedule service.
Example 3: Get extended members of service objects
PS C:\\>Get-Service| Get-Member -View Extended
TypeName: System.ServiceProcess.ServiceController
Name MemberType Definition
---- ---------- ----------
Name AliasProperty Name = ServiceName
This command gets the methods and properties of service objects that were extended by using the Types.ps1xml file or the Add-Member cmdlet.
The Get-Member command uses the View parameter to get only the extended members of the service objects. In this case, the extended member is the
Name property, which is an alias property of the ServiceName property.
Example 4: Get script properties of event log objects
PS C:\\>Get-EventLog -Log System | Get-Member -MemberType ScriptProperty
TypeName: System.Diagnostics.EventLogEntry
Name MemberType Definition
---- ---------- ----------
EventID ScriptProperty System.Object EventID {get=$this.get_EventID() -band 0xFFFF;}
This command gets the script properties of event log objects in the System log in Event Viewer.
The command uses the MemberType parameter to get only objects with a value of ScriptProperty for their MemberType property.
The command returns the EventID property of the EventLog object.
Example 5: Get objects with a specified property
PS C:\\>$A = "Get-Process", "Get-Service", "Get-Culture", "Get-PSDrive", "Get-ExecutionPolicy"
PS C:\\> ForEach ($Cmdlet in $A) {Invoke-Command $Cmdlet | Get-Member -Name MachineName}
TypeName: System.Diagnostics.Process
Name MemberType Definition
---- ---------- ----------
MachineName Property System.String MachineName {get;}
TypeName: System.ServiceProcess.ServiceController
Name MemberType Definition
---- ---------- ----------
MachineName Property System.String MachineName {get;set;}
This command gets objects that have a MachineName property from a list of cmdlets.
The first command stores the names of several cmdlets in the $A variable.
The second command uses a ForEach statement to invoke each command, send the results to Get-Member , and limit the results from Get-Member to
members that have the name MachineName.
The results show that only process objects ( System.Diagnostics.Process ) and service objects ( System.ServiceProcess.ServiceController ) have a
MachineName property.
Example 6: Get members for an array
PS C:\\>$A = Get-Member - InputObject @(1)
PS C:\\> $A.Count
1 PS C:\\>$A = Get-Member -InputObject 1,2,3
TypeName: System.Object[]
Name MemberType Definition
---- ---------- ----------
Count AliasProperty Count = Length
Address Method System.Object& Address(Int32 )
Clone Method System.Object Clone()
... PS C:\\>$A.Count
1
This example demonstrates how to find the properties and methods of an array of objects when you have only one object of the given type.
Because the goal of the command is to find the properties of an array, the first command uses the InputObject parameter. It uses the at symbol (@)
to indicate an array. In this case, the array contains only one object, the integer 1.
The third command uses the Get-Member cmdlet to get the properties and methods of an array of integers, and the command saves them in the $A
variable.
The fourth command uses the Count property of the array to find the number of objects in the $A variable.
Example 7: Determine which object properties you can set
PS C:\\>$File = Get-Item c:\\test\\textFile.txt
PS C:\\> $File.psobject.properties | Where-Object {$_.issettable} | Format-Table -Property name
Name
----
PSPath
PSParentPath
PSChildName
PSDrive
PSProvider
PSIsContainer
IsReadOnly
CreationTime
CreationTimeUtc
LastAccessTime
LastAccessTimeUtc
LastWriteTime
LastWriteTimeUtc
Attributes PS C:\\>[appdomain]::CurrentDomain.GetAssemblies() | ForEach-Object { $_.getexportedtypes() } | ForEach-Object {$_.getproperties() |
Where-Object {$_.canwrite }} | Select-Object reflectedtype, name
This example shows how to determine which properties of an object can be changed. The example uses a file, but you can use this command format to
find the changeable properties of any object in Windows PowerShell.
The first command uses the Get-Item cmdlet to get a text file, and then it saves the file object in the $File variable.
The second command gets all of the changeable properties of the file object in the $File variable and displays the names of the properties in a
table.
The third command gets the changeable properties of all objects in your Windows PowerShell session.
Example 8: Get members of each item in a collection
PS C:\\>$S = Get-Service
PS C:\\> $S | Get-Member
TypeName: System.ServiceProcess.ServiceController
Name MemberType Definition
---- ---------- ----------
Name AliasProperty Name = ServiceName
RequiredServices AliasProperty RequiredServices = ServicesDependedOn
Disposed Event System.EventHandler Disposed(System.Object, System.EventArgs
Close Method System.Void Close()
Continue Method System.Void Continue()
CreateObjRef Method System.Runtime.Remoting.ObjRef CreateObjRef(type requestedTy
Dispose Method System.Void Dispose()
... PS C:\\>Get-Member -InputObject $S
TypeName: System.Object[]
Name MemberType Definition
---- ---------- ----------
Count AliasProperty Count = Length
Address Method System.Object&, mscorlib, Version=2.0.0.0, Cultu
Clone Method System.Object Clone()
CopyTo Method System.Void CopyTo(array array, int index), Syst
Equals Method bool Equals(System.Object obj)
Get Method System.Object Get(int )
GetEnumerator Method System.Collections.IEnumerator GetEnumerator()
GetHashCode Method int GetHashCode()
...
This example shows how the InputObject parameter works in the Get-Member cmdlet. When you use the InputObject parameter to get the members of a
collection, Get-Member gets the members of the collection. When you pipe a collection of objects to Get-Member , Get-Member gets the members of
each item in the collection.
The first command gets the services on the local computer and saves the services in the $S variable.
The second command pipes the $S variable to the Get-Member cmdlet. Get-Member gets the types of each member of $S and the members of that type. In
this case, it gets ServiceController objects and lists the members, such as RequiredServices and Close.
The third command uses the InputObject parameter of Get-Member to submit the $S variable. Get-Member gets the type ( System.Object[] ) and the
members of the collection (or array) of ServiceController objects, such as Count and Clone.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkId=821792
Add-Member
SYNOPSIS
Gets the properties and methods of objects.
SYNTAX
Get-Member [[-Name] <String[]>] [-Force] [-InputObject <PSObject>] [-MemberType {AliasProperty | CodeProperty | Property | NoteProperty |
ScriptProperty | Properties | PropertySet | Method | CodeMethod | ScriptMethod | Methods | ParameterizedProperty | MemberSet | Event | Dynamic |
All}] [-Static] [-View {Extended | Adapted | Base | All}] [<CommonParameters>]
DESCRIPTION
The Get-Member cmdlet gets the members, the properties and methods, of objects.
To specify the object, use the InputObject parameter or pipe an object to Get-Member . To get information about static members, the members of the
class, not of the instance, use the Static parameter. To get only certain types of members, such as NoteProperties , use the MemberType parameter.
PARAMETERS
-Force [<SwitchParameter>]
Adds the intrinsic members (PSBase, PSAdapted, PSObject, PSTypeNames) and the compiler-generated get_ and set_ methods to the display. By
default, Get-Member gets these properties in all views other than Base and Adapted, but it does not display them.
The following list describes the properties that are added when you use the Force parameter:
- PSBase: The original properties of the .NET Framework object without extension or adaptation. These are the properties defined for the
object class and listed in MSDN.
- PSAdapted. The properties and methods defined in the Windows PowerShell extended type system.
- PSExtended. The properties and methods that were added in the Types.ps1xml files or by using the Add-Member cmdlet.
- PSObject. The adapter that converts the base object to a Windows PowerShell PSObject object. - PSTypeNames. A list of object types that
describe the object, in order of specificity. When formatting the object, Windows PowerShell searches for the types in the Format.ps1xml files
in the Windows PowerShell installation directory ($pshome). It uses the formatting definition for the first type that it finds.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-InputObject <PSObject>
Specifies the object whose members are retrieved.
Using the InputObject parameter is not the same as piping an object to Get-Member . The differences are as follows:
- When you pipe a collection of objects to Get-Member , Get-Member gets the members of the individual objects in the collection, such as the
properties of each string in an array of strings. - When you use InputObject to submit a collection of objects, Get-Member gets the members of
the collection, such as the properties of the array in an array of strings.
Required? false
Position? named
Default value None
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-MemberType <PSMemberTypes>
Specifies the member type that this cmdlet gets. The default is All.
The acceptable values for this parameter are:
- AliasProperty
- CodeProperty
- Property
- NoteProperty
- ScriptProperty
- Properties
- PropertySet
- Method
- CodeMethod
- ScriptMethod
- Methods
- ParameterizedProperty
- MemberSet
- Event
- Dynamic
- All
For information about these values, see PSMemberTypes
Enumeration"https://msdn.microsoft.com/en-us/librar ... s.85).aspx
(https://msdn.microsoft.com/en-us/librar ... s.85).aspx ) in MSDN.
Not all objects have every type of member. If you specify a member type that the object does not have, Windows PowerShell returns a null value.
To get related types of members, such as all extended members, use the View parameter. If you use the MemberType parameter with the Static or
View parameters, Get-Member gets the members that belong to both sets.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Name <String[]>
Specifies the names of one or more properties or methods of the object. Get-Member gets only the specified properties and methods.
If you use the Name parameter with the MemberType , View , or Static parameter, Get-Member gets only the members that satisfy the criteria of
all parameters.
To get a static member by name, use the Static parameter with the Name parameter.
Required? false
Position? 0
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Static [<SwitchParameter>]
Indicates that this cmdlet gets only the static properties and methods of the object.
Static properties and methods are defined on the class of objects, not on any particular instance of the class.
If you use the Static parameter with the View parameter, the View parameter is ignored. If you use the Static parameter with the MemberType
parameter, Get-Member gets only the members that belong to both sets.
Required? false
Position? named
Default value False
Accept pipeline input? False
Accept wildcard characters? false
-View <PSMemberViewTypes>
Specifies that this cmdlet gets only particular types properties and methods. Specify one or more of the values. The default is Adapted,
Extended.
The acceptable values for this parameter are:
- Base. Gets only the original properties and methods of the .NET Framework object (without extension or adaptation).
- Adapted. Gets only the properties and methods defined in the Windows PowerShell extended type system.
- Extended. Gets only the properties and methods that were added in the Types.ps1xml files or by using the Add-Member cmdlet.
- All. Gets the members in the Base, Adapted, and Extended views.
The View parameter determines the members retrieved, not just the display of those members.
To get particular member types, such as script properties, use the MemberType parameter. If you use the MemberType and View parameters in the
same command, Get-Member gets the members that belong to both sets. If you use the Static and View parameters in the same command, the View
parameter is ignored.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
System.Management.Automation.PSObject
You can pipe any object to Get-Member .
OUTPUTS
Microsoft.PowerShell.Commands.MemberDefinition
Get-Member returns an object for each property or method that its gets.
NOTES
You can get information about a collection object either by using the InputObject parameter or by piping the object, preceded by a comma, to
Get-Member *.
You can use the $This automatic variable in script blocks that define the values of new properties and methods. The $This variable refers to
the instance of the object to which the properties and methods are being added. For more information about the $This variable, see
about_Automatic_Variables.
*
Example 1: Get the members of process objects
PS C:\\>Get-Service | Get-Member
TypeName: System.ServiceProcess.ServiceController
Name MemberType Definition
---- ---------- ----------
Name AliasProperty Name = ServiceName
Close Method System.Void Close()
Continue Method System.Void Continue()
CreateObjRef Method System.Runtime.Remoting.ObjRef CreateObjRef(Type requestedType)
Dispose Method System.Void Dispose()
Equals Method System.Boolean Equals(Object obj)
ExecuteCommand Method System.Void ExecuteCommand(Int32 command)
GetHashCode Method System.Int32 GetHashCode()
GetLifetimeService Method System.Object GetLifetimeService()
GetType Method System.Type GetType()
InitializeLifetimeService Method System.Object InitializeLifetimeService()
Pause Method System.Void Pause()
Refresh Method System.Void Refresh()
Start Method System.Void Start(), System.Void Start(String[] args)
Stop Method System.Void Stop()
ToString Method System.String ToString()
WaitForStatus Method System.Void WaitForStatus(ServiceControllerStatus desiredStatus), System.Voi...
CanPauseAndContinue Property System.Boolean CanPauseAndContinue {get;}
CanShutdown Property System.Boolean CanShutdown {get;}
CanStop Property System.Boolean CanStop {get;}
Container Property System.ComponentModel.IContainer Container {get;}
DependentServices Property System.ServiceProcess.ServiceController[] DependentServices {get;}
DisplayName Property System.String DisplayName {get;set;}
MachineName Property System.String MachineName {get;set;}
ServiceHandle Property System.Runtime.InteropServices.SafeHandle ServiceHandle {get;}
ServiceName Property System.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;}
Status Property System.ServiceProcess.ServiceControllerStatus Status {get;}
This command displays the properties and methods of the process objects (System.ServiceProcess.ServiceController) that are generated by the
Get-Service cmdlet.
The command uses the pipeline operator (|) to send the output of a Get-Service command to Get-Member .
Because the Get-Member part of the command does not have any parameters, it uses all of the default values. As such, it gets all member types, but
it does not get static members and does not display intrinsic members.
Example 2: Get members of service objects
PS C:\\>Get-Service | Get-Member -Force
PS C:\\> (Get-Service -Schedule).PSBase
This example gets all of the members (properties and methods) of the service objects (System.ServiceProcess.ServiceController) retrieved by the
Get-Service cmdlet, including the intrinsic members, such as PSBase and PSObject, and the get_ and set_ methods.
The first command uses the Get-Service cmdlet to get objects that represent the services on the system. It uses a pipeline operator (|) to pass
the service objects to the Get-Member cmdlet.
The Get-Member command uses the Force parameter to add the intrinsic members and compiler-generated members of the objects to the display.
Get-Member gets these members, but it hides them by default.
You can use these properties and methods in the same way that you would use an adapted method of the object. The second command shows how to
display the value of the PSBase property of the Schedule service.
Example 3: Get extended members of service objects
PS C:\\>Get-Service| Get-Member -View Extended
TypeName: System.ServiceProcess.ServiceController
Name MemberType Definition
---- ---------- ----------
Name AliasProperty Name = ServiceName
This command gets the methods and properties of service objects that were extended by using the Types.ps1xml file or the Add-Member cmdlet.
The Get-Member command uses the View parameter to get only the extended members of the service objects. In this case, the extended member is the
Name property, which is an alias property of the ServiceName property.
Example 4: Get script properties of event log objects
PS C:\\>Get-EventLog -Log System | Get-Member -MemberType ScriptProperty
TypeName: System.Diagnostics.EventLogEntry
Name MemberType Definition
---- ---------- ----------
EventID ScriptProperty System.Object EventID {get=$this.get_EventID() -band 0xFFFF;}
This command gets the script properties of event log objects in the System log in Event Viewer.
The command uses the MemberType parameter to get only objects with a value of ScriptProperty for their MemberType property.
The command returns the EventID property of the EventLog object.
Example 5: Get objects with a specified property
PS C:\\>$A = "Get-Process", "Get-Service", "Get-Culture", "Get-PSDrive", "Get-ExecutionPolicy"
PS C:\\> ForEach ($Cmdlet in $A) {Invoke-Command $Cmdlet | Get-Member -Name MachineName}
TypeName: System.Diagnostics.Process
Name MemberType Definition
---- ---------- ----------
MachineName Property System.String MachineName {get;}
TypeName: System.ServiceProcess.ServiceController
Name MemberType Definition
---- ---------- ----------
MachineName Property System.String MachineName {get;set;}
This command gets objects that have a MachineName property from a list of cmdlets.
The first command stores the names of several cmdlets in the $A variable.
The second command uses a ForEach statement to invoke each command, send the results to Get-Member , and limit the results from Get-Member to
members that have the name MachineName.
The results show that only process objects ( System.Diagnostics.Process ) and service objects ( System.ServiceProcess.ServiceController ) have a
MachineName property.
Example 6: Get members for an array
PS C:\\>$A = Get-Member - InputObject @(1)
PS C:\\> $A.Count
1 PS C:\\>$A = Get-Member -InputObject 1,2,3
TypeName: System.Object[]
Name MemberType Definition
---- ---------- ----------
Count AliasProperty Count = Length
Address Method System.Object& Address(Int32 )
Clone Method System.Object Clone()
... PS C:\\>$A.Count
1
This example demonstrates how to find the properties and methods of an array of objects when you have only one object of the given type.
Because the goal of the command is to find the properties of an array, the first command uses the InputObject parameter. It uses the at symbol (@)
to indicate an array. In this case, the array contains only one object, the integer 1.
The third command uses the Get-Member cmdlet to get the properties and methods of an array of integers, and the command saves them in the $A
variable.
The fourth command uses the Count property of the array to find the number of objects in the $A variable.
Example 7: Determine which object properties you can set
PS C:\\>$File = Get-Item c:\\test\\textFile.txt
PS C:\\> $File.psobject.properties | Where-Object {$_.issettable} | Format-Table -Property name
Name
----
PSPath
PSParentPath
PSChildName
PSDrive
PSProvider
PSIsContainer
IsReadOnly
CreationTime
CreationTimeUtc
LastAccessTime
LastAccessTimeUtc
LastWriteTime
LastWriteTimeUtc
Attributes PS C:\\>[appdomain]::CurrentDomain.GetAssemblies() | ForEach-Object { $_.getexportedtypes() } | ForEach-Object {$_.getproperties() |
Where-Object {$_.canwrite }} | Select-Object reflectedtype, name
This example shows how to determine which properties of an object can be changed. The example uses a file, but you can use this command format to
find the changeable properties of any object in Windows PowerShell.
The first command uses the Get-Item cmdlet to get a text file, and then it saves the file object in the $File variable.
The second command gets all of the changeable properties of the file object in the $File variable and displays the names of the properties in a
table.
The third command gets the changeable properties of all objects in your Windows PowerShell session.
Example 8: Get members of each item in a collection
PS C:\\>$S = Get-Service
PS C:\\> $S | Get-Member
TypeName: System.ServiceProcess.ServiceController
Name MemberType Definition
---- ---------- ----------
Name AliasProperty Name = ServiceName
RequiredServices AliasProperty RequiredServices = ServicesDependedOn
Disposed Event System.EventHandler Disposed(System.Object, System.EventArgs
Close Method System.Void Close()
Continue Method System.Void Continue()
CreateObjRef Method System.Runtime.Remoting.ObjRef CreateObjRef(type requestedTy
Dispose Method System.Void Dispose()
... PS C:\\>Get-Member -InputObject $S
TypeName: System.Object[]
Name MemberType Definition
---- ---------- ----------
Count AliasProperty Count = Length
Address Method System.Object&, mscorlib, Version=2.0.0.0, Cultu
Clone Method System.Object Clone()
CopyTo Method System.Void CopyTo(array array, int index), Syst
Equals Method bool Equals(System.Object obj)
Get Method System.Object Get(int )
GetEnumerator Method System.Collections.IEnumerator GetEnumerator()
GetHashCode Method int GetHashCode()
...
This example shows how the InputObject parameter works in the Get-Member cmdlet. When you use the InputObject parameter to get the members of a
collection, Get-Member gets the members of the collection. When you pipe a collection of objects to Get-Member , Get-Member gets the members of
each item in the collection.
The first command gets the services on the local computer and saves the services in the $S variable.
The second command pipes the $S variable to the Get-Member cmdlet. Get-Member gets the types of each member of $S and the members of that type. In
this case, it gets ServiceController objects and lists the members, such as RequiredServices and Close.
The third command uses the InputObject parameter of Get-Member to submit the $S variable. Get-Member gets the type ( System.Object[] ) and the
members of the collection (or array) of ServiceController objects, such as Count and Clone.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkId=821792
Add-Member