Why is -property * needed?

matthew-plunkett · June 10, 2013, 1:38am

Contrast the two statements below.Â The behavior is odd to me.Â If both things are of type Microsoft.ActiveDirectory.Management.ADGroup, then why is it necessary to specify -property * (or just whatever extended property you’re looking for) in order to have that field whenÂ referring to an object returned by get-adgroup?Â I had thought when you selected or sorted by certain properties, that all you were doing was deciding what was output to the screen or filtered or whatever, but it appears that that data is simply not present unless you specify that you want it.Â Does that mean that what’s returned is not really of the type specified?Â Or it’s a copy with the nonselected properties set to $null or similar?

get-adgroup “<group name>” | gm
Â Â TypeName: Microsoft.ActiveDirectory.Management.ADGroup

NameÂ Â Â Â Â Â Â Â Â Â Â Â Â MemberTypeÂ Â Â Â Â Â Â Â Â Â Â Definition
----Â Â Â Â Â Â Â Â Â Â Â Â Â ----------Â Â Â Â Â Â Â Â Â Â Â ----------
ContainsÂ Â Â Â Â Â Â Â Â MethodÂ Â Â Â Â Â Â Â Â Â Â Â Â Â Â bool Contains(string propertyName)
EqualsÂ Â Â Â Â Â Â Â Â Â Â MethodÂ Â Â Â Â Â Â Â Â Â Â Â Â Â Â bool Equals(System.Object obj)
GetEnumeratorÂ Â Â Â MethodÂ Â Â Â Â Â Â Â Â Â Â Â Â Â Â System.Collections.IDictionaryEnumer…
GetHashCodeÂ Â Â Â Â Â MethodÂ Â Â Â Â Â Â Â Â Â Â Â Â Â Â int GetHashCode()
GetTypeÂ Â Â Â Â Â Â Â Â Â MethodÂ Â Â Â Â Â Â Â Â Â Â Â Â Â Â type GetType()
ToStringÂ Â Â Â Â Â Â Â Â MethodÂ Â Â Â Â Â Â Â Â Â Â Â Â Â Â string ToString()
ItemÂ Â Â Â Â Â Â Â Â Â Â Â Â ParameterizedProperty Microsoft.ActiveDirectory.Management…
DistinguishedName PropertyÂ Â Â Â Â Â Â Â Â Â Â Â Â System.String DistinguishedName {get…
GroupCategoryÂ Â Â Â PropertyÂ Â Â Â Â Â Â Â Â Â Â Â Â System.Nullable1[[Microsoft.ActiveD... GroupScopeÂ Â Â Â Â Â Â PropertyÂ Â Â Â Â Â Â Â Â Â Â Â Â System.Nullable1[[Microsoft.ActiveD…
NameÂ Â Â Â Â Â Â Â Â Â Â Â Â PropertyÂ Â Â Â Â Â Â Â Â Â Â Â Â System.String Name {get;}
ObjectClassÂ Â Â Â Â Â PropertyÂ Â Â Â Â Â Â Â Â Â Â Â Â System.String ObjectClass {get;set;}
ObjectGUIDÂ Â Â Â Â Â Â PropertyÂ Â Â Â Â Â Â Â Â Â Â Â Â System.Nullable`1[[System.Guid, msco…
SamAccountNameÂ Â Â PropertyÂ Â Â Â Â Â Â Â Â Â Â Â Â System.String SamAccountName {get;set;}
SIDÂ Â Â Â Â Â Â Â Â Â Â Â Â Â PropertyÂ Â Â Â Â Â Â Â Â Â Â Â Â System.Security.Principal.SecurityId…

H$ get-adgroup “<group name>” -property * | gm
Â Â TypeName: Microsoft.ActiveDirectory.Management.ADGroup

NameÂ Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â MemberTypeÂ Â Â Â Â Â Â Â Â Â Â Definition
----Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â ----------Â Â Â Â Â Â Â Â Â Â Â ----------
ContainsÂ Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â MethodÂ Â Â Â Â Â Â Â Â Â Â Â Â Â Â bool Contains(string p…
EqualsÂ Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â MethodÂ Â Â Â Â Â Â Â Â Â Â Â Â Â Â bool Equals(System.Obj…
GetEnumeratorÂ Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â MethodÂ Â Â Â Â Â Â Â Â Â Â Â Â Â Â System.Collections.IDi…
GetHashCodeÂ Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â MethodÂ Â Â Â Â Â Â Â Â Â Â Â Â Â Â int GetHashCode()
GetTypeÂ Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â MethodÂ Â Â Â Â Â Â Â Â Â Â Â Â Â Â type GetType()
ToStringÂ Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â MethodÂ Â Â Â Â Â Â Â Â Â Â Â Â Â Â string ToString()
ItemÂ Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â ParameterizedProperty Microsoft.ActiveDirect…
CanonicalNameÂ Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â PropertyÂ Â Â Â Â Â Â Â Â Â Â Â Â System.String Canonica…
CNÂ Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â PropertyÂ Â Â Â Â Â Â Â Â Â Â Â Â System.String CN {get;}
CreatedÂ Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â PropertyÂ Â Â Â Â Â Â Â Â Â Â Â Â System.DateTime Create…
createTimeStampÂ Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â PropertyÂ Â Â Â Â Â Â Â Â Â Â Â Â System.DateTime create…
DeletedÂ Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â PropertyÂ Â Â Â Â Â Â Â Â Â Â Â Â System.Boolean Deleted…
DescriptionÂ Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â PropertyÂ Â Â Â Â Â Â Â Â Â Â Â Â System.String Descript…
DisplayNameÂ Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â PropertyÂ Â Â Â Â Â Â Â Â Â Â Â Â System.String DisplayN…
DistinguishedNameÂ Â Â Â Â Â Â Â Â Â Â Â Â Â PropertyÂ Â Â Â Â Â Â Â Â Â Â Â Â System.String Distingu…
dSCorePropagationDataÂ Â Â Â Â Â Â Â Â Â PropertyÂ Â Â Â Â Â Â Â Â Â Â Â Â Microsoft.ActiveDirect…
GroupCategoryÂ Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â Â PropertyÂ Â Â Â Â Â Â Â Â Â Â Â Â System.Nullable`1[[Mic…

donj · June 10, 2013, 1:58am

It’s a performance thing - same reason you have to specify -filter. The DC by default returns a subset of properties just to make its own life easier. So if you want more than that, you use -Prop. You can useÂ -Prop * to get everything, or specify a list of properties if you want less than everything.

matthew-plunkett · June 10, 2013, 3:20am

Thanks, that’s interesting.Â I hadn’t thought about it having to go to the DC for the information.

Topic		Replies	Views
Get-Adgroup member members properties PowerShell Help	2	167	May 4, 2016
AD user properties and group membership check combined PowerShell Help	4	199	May 5, 2020
Confusion on - filter vs -property vs select-object PowerShell Help	6	242	April 20, 2022
Tabulate property values? PowerShell Help	4	114	May 24, 2015
Get-ADGroup not showing all attributes listed in ADSI Edit PowerShell Help	2	127	January 30, 2015

Why is -property * needed?

Related Topics