News

#Most Recent News

2016/12/27 - gShell v.0.10 Beta Released!

Breaking changes

This release apologetically contains a few breaking changes.

• The ubiquitous -Domain parameter has been changed to -GAuthId. You can now supply a user, an email address or a domain that you would like gShell to use for the retrieval of stored authentication information. (This in turn allows cmdlets that have a specific -Domain parameter to work 100% now.)
• Invoke-ScopeManager has been updated to the more fitting Invoke-GShellScopeManager and the option for read-write has been changed to o for other, since some included are modify or similar.

Google APIs being Depreciated

Google is depreciating both the Admin Settings and the Email Settings APIs, which will affect the related GAdminSettings and GEmailSettings cmdlets.

Removed Cmdlets

• Get-GAUserProperty
• New-GASchemaField
• New-GASchemaFieldCollection
• New-GAUserProperty
• New-GAUserPropertyCollection
• Remove-GAUserProperty

Renamed Cmdlets

• Invoke-ScopeManager is now Invoke-GShellScopeManager

New Cmdlets

Many more cmdlets have been added, over 30! The accessory cmdlets aren't listed below, but the primary cmdlets of note are:

New Directory Cmdlets

• Get-GACalendar
• Set-GACalendar
• Remove-GACalendar
• New-GACalendar
• Invoke-GAChromeosdevice
• Set-GAUserAdmin

New Gmail Cmdlets

• Get-GGmailFilter
• Get-GGmailForwardingAddress
• Get-GGmailSendAs
• Get-GGmailSettings
• New-GGmailFilter
• New-GGmailForwardingAddress
• New-GGmailSendAs
• Remove-GGmailFilter
• Remove-GGmailForwardingAddress
• Remove-GGmailSendAs
• Send-GGmailSendAsVerification
• Set-GGmailSendAs
• Set-GGmailSettings

New Classroom Cmdlets

• Get-GClassroomCourseWork
• Get-GClassroomGuardian
• Get-GClassroomGuardianInvitation
• Get-GClassroomStudentSubmission
• New-GClassroomCourseWork
• New-GClassroomGuardianInvitation
• Remove-GClassroomGuardian
• Set-GClassroomGuardianInvitation
• Set-GClassroomStudentSubmission
• Set-GClassroomStudentSubmissionAttachment

New GShell Cmdlets

• New-GShellStandardQueryParametersObj

Main Fixes

• GShell should hopefully be able to handle multidomain setups and primary domain setups now.
• Fixed scope manager, as mentioned above
• Cmdlets should now be able to support the standard query parameters of fields, quotaUser and userIp where applicable (useful for returning more information from the GDrive cmdlets!)
• Fixed progress bars to more appropriately represent the situation.
• Fixed issues with some parameters being the wrong collection type to now allow use of powershell standard collections
• Fixed documentation of some cmdlets and parameters
• Depreciated some old and inaccurate gShell mess like the GAPropertyCollection cmdlets. What was I thinking?
• Other minor bugs and issues.

OlderNews

2016/07/19 - gShell v.0.9 Released!

This release adds a few minor features. And by minor, I mean huge! With now over 300 Cmdlets (338 at current count, though that will likely change around a bit) gShell covers all of the APIs that are in the Admin SDK. In addition, the Calendar, Gmail and Google Drive APIs have been represented as well. You can find a list of all Cmdlets in the Cmdlets Index.

Furthermore, support for service accounts in Calendar, Gmail and Drive Cmdlets has been added. This allows the administrator to call Cmdlets on behalf of one of their users where the Cmdlet would normally only work for the user making the call. Information on the service accounts can be found here.

Also, gShell now contains a large number of Accessory Cmdlets. These cmdlets end in *Obj, and they create objects that you need to pass in to other Cmdlets. For example, if you were trying to create a New Calendar Event you would see a parameter for EventBody which is of type Event. So, look for New-GCalendarEventObj and use that! Easy peasy.

A few other minor additions and changes to be noted:

• By default, gShell now uses the .Json format for storing your authentication information. You can still change this with Set-gShellSettings.
• By default, gShell now stores the settings and the authentication information in the same directory as the .dll files in the PowerShell Modules. This can now be changed to any directory you want, also with Set-gShellSettings.
• New-GAUser and Set-GAUser now contain a new parameter that accepts passwords via a SecureString, great for things that I'm sure you'll figure out.
• All documentation is now generated from the code, but can still be edited by the community. The examples are mostly generated via code, so if something isn't right, OR if you'd like to add more examples, please feel free! This has become bigger than me.
• Similarly, much of the dependencies have also been generated and integrated with the project, which means less .dll clutter! I mean, that was basically the biggest update here that nobody else will know.
• If you're still reading, thank you. :)

2016/01/20 - gShell v.0.0.8.1 Released!

This release aims to fix some oversights and misunderstandings around the previous release. Mainly:

• You can now save your auth settings in JSON so they're easy to view and troubleshoot, if needed. However, this means it's less secure! And json is not the default format.
• ScopeManager has been re-tooled to only work with one API at a time, but with some additional parameters. This is due to...
• Significant overhaul of the underlying authentication flow of gShell, completely rewritten to be betterer.er. Had to do this because...
• gShell no longer stores all permissions in one token per user. Instead, each domain has one or more users, who each have one or more APIs, and each API has it's own auth settings that must be stored.
• Includes a hotfix for 0.0.8.1 which fixes a missing file in the installer and an issue in the new authentication. Apparently not paying your QA team means crap releases, even when you are your own QA team.

2015/04/15 - gShell v.0.0.7.0 Released!

This release is not too shabby, featuring a ton of new stuff (41 Cmdlets - whoa)!

• A new way to control the scopes (permissions ) you want to grant to gShell, via an interactive wizard!
• The ability to set your very own Client Secrets, so you can set up a Google Project and have your own API quotas!
• The rest of the massive Directory APIs... in Cmdlet form!
• The Discovery API, also in Cmdlet form!
• Refactored gShell Utility Cmdlets!
• The Wiki can now be updated by anyone! From now on, Wiki Pages will get the bare minimum information - this will allow me to spend more time on the project, and less on writing things up. Plus you can add examples, fix typos, etc.

Here's the list of APIs that finish out the Admin Directory API.

• Asp: Get-GAAsp, Remove-GAAsp
• Channel: Stop-GAChannel
• Chrome OS Device: Get-GAChromeosdevice, Set-GAChromeosdevice
• Mobile Device: Get-GAMobiledevice, Remove-GAMobiledevice, Invoke-GAMobiledevice
• Notification: Get-GANotification, Remove-GANotification, Set-GANotification
• Org Unit: New-GAOrgUnit, Get-GAOrgUnit, Remove-GAOrgUnit, Set-GAOrgUnit
• Schema: Get-GASchema, Remove-GASchema, Set-GASchema, New-GASchema, Add-GASchema
• SchemaField: New-GASchemaField, New-GASchemaFieldCollection
• Token: Get-GAToken, Remove-GAToken
• User Photo: Get-GAUserPhoto, Remove-GAUserPhoto, Set-GAUserPhoto
• Verification Code: Get-GAVerificationCode, Revoke-GAVerificationCode, New-GAVerificationCode

The Discovery API doesn't need authentication because it just provides you with a list of information on the APIs. So meta!

• List Get-GDiscoveryList
• RestData Get-GDiscoveryRestData

In addition, I have altered some of the gShell Utility Cmdlets (both the names and the functionality), and added a very important new one!

• Client Secrets: Get-gShellClientSecrets, Set-gShellClientSecrets, Remove-gShellClientSecrets
• Domain: Get-gShellDomain, Set-gShellDomain, Remove-gShellDomain
• User: Get-gShellUser, Remove-gShellUser
• Scope Manager: Invoke-ScopeManager

About the Scope Manager - What and Why?

Now when you try to run gShell for the first time (or with a new domain or user) you will automatically be prompted to run through the same kind of scope wizard that you'll find if you manually run Invoke-ScopeManager. The best part is that once you authenticate you'll be returned to gShell without interrupting the rest of your Cmdlet. Sweet!

2015/03/13 - gShell v.0.0.6.0 Released!

And what a release it is! The biggest news of this release is that gShell is now available for .Net developers and PowerShell users alike! All the power of the gShell authentication system bundled up in a tidy package, allowing you to make API calls in as little as three lines. Check out the DotNet Guide for more info on that.

Almost as big is the addition of the FULL Reports API - it's a great addition of the following Cmdlets:

• Get-GRepActivity
• Watch-GRepActivity
• Stop-GRepChannel
• Get-GRepCustomerUsageReport
• Get-GRepUserUsageReport

These Cmdlets have been fairly tested as best as I can muster, but there are likely to be little bugs here and there. Again, if you find any please let me know

Furthermore, the following Cmdlets have been updated or changed:

• Set-GAUser: A new parameter, -OrgUnitPath, has been added to allow moving users around between Google Org Units.
• Get-GAGroup: A new paramater, -UserName, has been added to allow retrieving all groups for one user.

Another biggish change is the removal of all Caching-related Cmdlet parameters. It was something silly I had added thinking it would be useful, but in reality it just confuscated everything and replaced an already existing PoSh staple - a variable (duh).

Finally, I've removed the GADrive cmdlets for now. Based on the restructuring of the underlying code and the way they were set up, I have decided to scrap those for now and they will reappear at a later time in a better format. If you really really need them, use a previous version. Sorry!

Find this release on the Downloads page.

2015/01/19 - gShell v.0.0.5.0 Released!

In this release, a few bugs have been worked out and some new functionality has been added. In addition, the project has been moved from Google Code to Github.

Bugs Fixed

• The issue affecting retrieval of more than one page of results has been resolved.
• The issue affecting retrieval of all user aliases and group members has been resolved.

New Additions

A handful of *GAUserProperty cmdlets have been added to help with the non-standard 'extra' information that can be added to a Google Apps user. The Cmdlets added are:

• Get-GAUserProperty
• New-GAUserProperty
• New-GAUserPropertyCollection
• Remove-GAUserProperty

For more information on how to use these Cmdlets, see the page on Working with User Properties.

In addition, the installer has been re-tuned so that the machine.config file no longer has to be touched! Yay being safe!

Finally, each Cmdlet has been outfitted to use the online help feature. When using it, your primary browser will open to the appropriate wiki page. For instance:

help Get-User -Online

###2015/01/19 No past news! It was all lost during the transition to Github - sorry! But instead of reading oldnews, let's take a moment and reflect...

Ahh, yeah. That's the stuff.

######Edited: 2016/07/19