GAUserProperty

#GAUserProperty

In gShell we separate the 'normal' properties you'd find on a user (such as first name, last name, suspended, etc) and the 'extended' properties that aren't part of the traditional workflow (such as Addresses, Ims, or ExternalIds). The reason for this separation is more about how things work under-the-hood as you can read more about in Working with User Properties.

Regardless, it's important to know that there are currently 7 types of additional properties that gShell defines and can work with:

• Address
• Email
• External Id
• Im (Instant Messenger)
• Phone
• Organization
• Relation

Each one of these objects is a different type of object (just as string is not int, and GAUser is not GAGroup), but as far as gShell is concerned they're all GAUserProperty objects. You can create any of these using the New-GAUserProperty Cmdlet, so take some time to check out the properties of each one.

#GAUserPropertyCollection

In order to update one of the above UserProperties for a user, we must first package it as a GAUserPropertyCollection. This is a customized object whose only job is to be a container for any and all additional user properties of the above seven types.

The features of note on this object type is that you have a method that you can call to add individual UserProperty objects to the collection. For instance, in a Collection stored in a variable:

$MyPropertyCollection.Add($MyImProperty)

If you absolutely need to update something on the Collection itself, you can do so by drilling down in to the individual properties.