AppVeyor post-build commit[ci skip]

Author: AppVeyor

PSMSGraph/PSMSGraph.psd1

@@ -20,7 +20,7 @@
     RootModule = 'PSMSGraph.psm1'
 
 	# Version number of this module.
-	ModuleVersion = '1.0.25.42'
+	ModuleVersion = '1.0.26.43'
 
 	# ID used to uniquely identify this module
 	GUID = '15978dcc-d5ad-4024-ab2a-28bdf946ece7'
@@ -129,38 +129,46 @@
 			# IconUri = ''
 
 			# ReleaseNotes of this module
-			ReleaseNotes = '# Version 1.0.25.42 (2017-04-22)
+			ReleaseNotes = '# Version 1.0.26.43 (2017-04-30)
 ## Functions
-### Get-GraphOauthAccessToken
-* Revised Invoke-WebRequest error handling. Now uses ```MSGraphAPI.Oauth.Exception``` to handle formating
-* Simplified error handling for JSON parsing
-* Revamped credential object creation for readbility.
-* Clean up debug code
+### Get-AADGroupByDisplayName
+* Fix error message to say Group instead of uuser and actually put the group name in the error
+* ```Write-Error``` now includes original exception with error message
 
-## Types
-### MSGraphAPI.Oauth.Exception
-* Added the ```MSGraphAPI.Oauth.Exception``` type to handle OAuth related ```Invoke-Webrequest``` Exceptions
-* New ScriptMethod JSONResponse converts the response stream from the ```Invoke-WebRequest``` exception from JSON to PSObject
+### Get-AADGroupById
+* ```Write-Error``` now includes original exception with error message
 
-## Test
-### Get-GraphOauthAccessToken.Unit.Tests.ps1
-* Added missing code coverage for ```Invoke-webRequest``` error handling
-* Add missing code coverage for JSON parsing error handling
-* Now at 100% code coverage for ```Get-GraphOauthAccessToken```!
+## Tests
+### Get-AADGroupByDisplayName.Unit.Tests.ps1
+* Added missing code coverage for ```Invoke-GrapRequest``` error handling
+* Now has 100% code coverage for ```Get-AADGroupByDisplayName```
 
-## Built Toolds
-### psake.ps1
-* Adjust recommit logic in PostDeploy task
-* Added ```!forcrecommit``` to override default ignores if needed
-* Added ```devlop``` to ignored branch for recommits as constant work in the develop branch leads to staging issues.
-* Added comment based help file header.
+### Get-AADGroupById.Unit.Tests.ps1
+* Added missing code coverage for ```Invoke-GrapRequest``` error handling
+* Now has 100% code coverage for ```Get-AADGroupById```
 
 ## Documentation
-### Get-GraphOauthAccessToken
-* Modifyed Description to something useful
-* adjusted formating on ```Resource``` parameter
-* Added ```Get-GraphOauthAuthorizationCode``` to Notes
-* Added ```Get-GraphOauthAuthorizationCode``` to Links'
+### Get-AADGroupByDisplayName
+* Re-worded synopsis
+* Add more helpful description
+* Added clarity about the required reource for Access Tokens
+* Fix typo in ```APIVersion``` parameter
+* Corrected Output to reflect the correct object type
+* Added the following links:
+    + ```Get-GraphOauthAccessToken```
+    + MSDN AAD Graph Group Operations
+    + MSDN AAD Graph Filter parameter
+
+### Get-AADGroupById
+* Re-worded synopsis
+* Add more helpful description
+* Added clarity about the required reource for Access Tokens
+* Added clarity on what ObjectID is required
+* Fixed typo in ```APIVersion``` parameter
+* Added the following links:
+    + ```Get-GraphOauthAccessToken```
+    + MSDN AAD Graph Group Operations
+    + MSDN AAD Graph Filter parameter'
 
 		} # End of PSData hashtable
 

RELEASE.md

@@ -1,3 +1,4 @@
+# Version 1.0.26.43 (2017-04-30)
 ## Functions
 ### Get-AADGroupByDisplayName
 * Fix error message to say Group instead of uuser and actually put the group name in the error
@@ -36,4 +37,4 @@
 * Added the following links:
     + ```Get-GraphOauthAccessToken```
     + MSDN AAD Graph Group Operations
-    + MSDN AAD Graph Filter parameter
+    + MSDN AAD Graph Filter parameter

docs/ChangeLog.md

@@ -1,3 +1,46 @@
+# Version 1.0.26.43 (2017-04-30)
+## Functions
+### Get-AADGroupByDisplayName
+* Fix error message to say Group instead of uuser and actually put the group name in the error
+* ```Write-Error``` now includes original exception with error message
+
+### Get-AADGroupById
+* ```Write-Error``` now includes original exception with error message
+
+## Tests
+### Get-AADGroupByDisplayName.Unit.Tests.ps1
+* Added missing code coverage for ```Invoke-GrapRequest``` error handling
+* Now has 100% code coverage for ```Get-AADGroupByDisplayName```
+
+### Get-AADGroupById.Unit.Tests.ps1
+* Added missing code coverage for ```Invoke-GrapRequest``` error handling
+* Now has 100% code coverage for ```Get-AADGroupById```
+
+## Documentation
+### Get-AADGroupByDisplayName
+* Re-worded synopsis
+* Add more helpful description
+* Added clarity about the required reource for Access Tokens
+* Fix typo in ```APIVersion``` parameter
+* Corrected Output to reflect the correct object type
+* Added the following links:
+    + ```Get-GraphOauthAccessToken```
+    + MSDN AAD Graph Group Operations
+    + MSDN AAD Graph Filter parameter
+
+### Get-AADGroupById
+* Re-worded synopsis
+* Add more helpful description
+* Added clarity about the required reource for Access Tokens
+* Added clarity on what ObjectID is required
+* Fixed typo in ```APIVersion``` parameter
+* Added the following links:
+    + ```Get-GraphOauthAccessToken```
+    + MSDN AAD Graph Group Operations
+    + MSDN AAD Graph Filter parameter
+
+
+
 # Version 1.0.25.42 (2017-04-22)
 ## Functions
 ### Get-GraphOauthAccessToken

docs/RELEASE.md

@@ -1,32 +1,40 @@
-# Version 1.0.25.42 (2017-04-22)
+# Version 1.0.26.43 (2017-04-30)
 ## Functions
-### Get-GraphOauthAccessToken
-* Revised Invoke-WebRequest error handling. Now uses ```MSGraphAPI.Oauth.Exception``` to handle formating
-* Simplified error handling for JSON parsing
-* Revamped credential object creation for readbility.
-* Clean up debug code
+### Get-AADGroupByDisplayName
+* Fix error message to say Group instead of uuser and actually put the group name in the error
+* ```Write-Error``` now includes original exception with error message
 
-## Types
-### MSGraphAPI.Oauth.Exception
-* Added the ```MSGraphAPI.Oauth.Exception``` type to handle OAuth related ```Invoke-Webrequest``` Exceptions
-* New ScriptMethod JSONResponse converts the response stream from the ```Invoke-WebRequest``` exception from JSON to PSObject
+### Get-AADGroupById
+* ```Write-Error``` now includes original exception with error message
 
-## Test
-### Get-GraphOauthAccessToken.Unit.Tests.ps1
-* Added missing code coverage for ```Invoke-webRequest``` error handling
-* Add missing code coverage for JSON parsing error handling
-* Now at 100% code coverage for ```Get-GraphOauthAccessToken```!
+## Tests
+### Get-AADGroupByDisplayName.Unit.Tests.ps1
+* Added missing code coverage for ```Invoke-GrapRequest``` error handling
+* Now has 100% code coverage for ```Get-AADGroupByDisplayName```
 
-## Built Toolds
-### psake.ps1
-* Adjust recommit logic in PostDeploy task
-* Added ```!forcrecommit``` to override default ignores if needed
-* Added ```devlop``` to ignored branch for recommits as constant work in the develop branch leads to staging issues.
-* Added comment based help file header.
+### Get-AADGroupById.Unit.Tests.ps1
+* Added missing code coverage for ```Invoke-GrapRequest``` error handling
+* Now has 100% code coverage for ```Get-AADGroupById```
 
 ## Documentation
-### Get-GraphOauthAccessToken
-* Modifyed Description to something useful
-* adjusted formating on ```Resource``` parameter
-* Added ```Get-GraphOauthAuthorizationCode``` to Notes
-* Added ```Get-GraphOauthAuthorizationCode``` to Links
+### Get-AADGroupByDisplayName
+* Re-worded synopsis
+* Add more helpful description
+* Added clarity about the required reource for Access Tokens
+* Fix typo in ```APIVersion``` parameter
+* Corrected Output to reflect the correct object type
+* Added the following links:
+    + ```Get-GraphOauthAccessToken```
+    + MSDN AAD Graph Group Operations
+    + MSDN AAD Graph Filter parameter
+
+### Get-AADGroupById
+* Re-worded synopsis
+* Add more helpful description
+* Added clarity about the required reource for Access Tokens
+* Added clarity on what ObjectID is required
+* Fixed typo in ```APIVersion``` parameter
+* Added the following links:
+    + ```Get-GraphOauthAccessToken```
+    + MSDN AAD Graph Group Operations
+    + MSDN AAD Graph Filter parameter

docs/functions/Get-AADGroupByDisplayName.md

@@ -1,7 +1,7 @@
 # Get-AADGroupByDisplayName
 
 ## SYNOPSIS
-Retrieves an Azure AD Group by the Display name
+Retrieves an Azure AD Group by the provided Display name
 
 ## SYNTAX
 
@@ -11,7 +11,19 @@ Get-AADGroupByDisplayName [-AccessToken] <Object> [-DisplayName] <String[]> [[-B
 ```
 
 ## DESCRIPTION
-Retrieves an Azure AD Group by the Display Name
+Searches Azure Active Directory Graph API for a Group by the provided display name. 
+The provided displayname must be a full case-insensitive match.
+Partial matches and
+wildcards are not supported.
+A MSGraphAPI.DirectoryObject.Group object will be
+returned for the matching group.
+
+Get-AADGroupByDisplayName requires a MSGraphAPI.Oauth.AccessToken issued for the 
+https://graph.windows.net resource.
+See the Get-GraphOauthAccessToken help for
+more information.
+
+Get-Help -Name Get-GraphOauthAccessToken -Parameter Resource
 
 ## EXAMPLES
 
@@ -24,6 +36,7 @@ $AADGroup = Get-AADGroupByDisplayName -AccessToken $GraphAccessToken -DisplayNam
 
 ### -AccessToken
 MSGraphAPI.Oauth.AccessToken object obtained from Get-GraphOauthAccessToken.
+Access Token must be issued for the https://graph.windows.net resource.
 
 ```yaml
 Type: Object
@@ -39,7 +52,8 @@ Accept wildcard characters: False
 
 ### -DisplayName
 The Group's Display Name.
-This must be an exact match and does not support wildcards
+This must be an exact case-insensitive match and does not 
+support wildcards or partial matches.
 
 ```yaml
 Type: String[]
@@ -72,7 +86,7 @@ Accept wildcard characters: False
 ```
 
 ### -APIversion
-version og the API to use.
+Version of the API to use.
 Default is 1.6
 
 ```yaml
@@ -122,7 +136,7 @@ Accept wildcard characters: False
 
 ## OUTPUTS
 
-### MSGraphAPI.DirectoryObject.ServicePrincipal
+### MSGraphAPI.DirectoryObject.Group
 
 ## NOTES
 
@@ -134,3 +148,9 @@ Accept wildcard characters: False
 
 [http://psmsgraph.readthedocs.io/en/latest/functions/Get-AADGroupByID](http://psmsgraph.readthedocs.io/en/latest/functions/Get-AADGroupByID)
 
+[http://psmsgraph.readthedocs.io/en/latest/functions/Get-GraphOauthAccessToken](http://psmsgraph.readthedocs.io/en/latest/functions/Get-GraphOauthAccessToken)
+
+[https://msdn.microsoft.com/en-us/library/azure/ad/graph/api/groups-operations](https://msdn.microsoft.com/en-us/library/azure/ad/graph/api/groups-operations)
+
+[https://msdn.microsoft.com/en-us/library/azure/ad/graph/howto/azure-ad-graph-api-supported-queries-filters-and-paging-options#filter](https://msdn.microsoft.com/en-us/library/azure/ad/graph/howto/azure-ad-graph-api-supported-queries-filters-and-paging-options#filter)
+

docs/functions/Get-AADGroupByID.md

@@ -1,7 +1,7 @@
 # Get-AADGroupByID
 
 ## SYNOPSIS
-Retrieves an Azure AD Group by their Object ID
+Retrieves an Azure AD Group by hte provided Object ID
 
 ## SYNTAX
 
@@ -11,7 +11,21 @@ Get-AADGroupByID [-AccessToken] <Object> [-ObjectId] <String[]> [[-BaseUrl] <Str
 ```
 
 ## DESCRIPTION
-Retrieves an Azure AD Group by their Object ID
+Searches Azure Active Directory Graph API for a Group by the provided Object ID. 
+The provided Object ID must be a full case-insensitive match.
+Partial matches and
+wildcards are not supported.
+The Object ID is the Azure AD Object ID and not the
+ObjectGUID synced from an On-prem AD.
+A MSGraphAPI.DirectoryObject.Group object will 
+be returned for the matching group.
+
+Get-AADGroupById requires a MSGraphAPI.Oauth.AccessToken issued for the 
+https://graph.windows.net resource.
+See the Get-GraphOauthAccessToken help for
+more information.
+
+Get-Help -Name Get-GraphOauthAccessToken -Parameter Resource
 
 ## EXAMPLES
 
@@ -24,6 +38,7 @@ $AADGroup = Get-AADGroupByID -AccessToken $GraphAccessToken -ObjectID d377e755-9
 
 ### -AccessToken
 MSGraphAPI.Oauth.AccessToken object obtained from Get-GraphOauthAccessToken.
+Access Token must be issued for the https://graph.windows.net resource.
 
 ```yaml
 Type: Object
@@ -38,7 +53,8 @@ Accept wildcard characters: False
 ```
 
 ### -ObjectId
-The group's ObjectID e.g d377e755-9365-400f-ab42-c0bf278c386e
+The group's Azure AD ObjectID e.g d377e755-9365-400f-ab42-c0bf278c386e
+This is not the ObjectGUID synced from an On-prem AD
 
 ```yaml
 Type: String[]
@@ -71,7 +87,7 @@ Accept wildcard characters: False
 ```
 
 ### -APIversion
-version og the API to use.
+Version of the API to use.
 Default is 1.6
 
 ```yaml
@@ -133,3 +149,9 @@ Accept wildcard characters: False
 
 [http://psmsgraph.readthedocs.io/en/latest/functions/Get-AADGroupByDisplayName](http://psmsgraph.readthedocs.io/en/latest/functions/Get-AADGroupByDisplayName)
 
+[http://psmsgraph.readthedocs.io/en/latest/functions/Get-GraphOauthAccessToken](http://psmsgraph.readthedocs.io/en/latest/functions/Get-GraphOauthAccessToken)
+
+[https://msdn.microsoft.com/en-us/library/azure/ad/graph/api/groups-operations](https://msdn.microsoft.com/en-us/library/azure/ad/graph/api/groups-operations)
+
+[https://msdn.microsoft.com/en-us/library/azure/ad/graph/howto/azure-ad-graph-api-supported-queries-filters-and-paging-options#filter](https://msdn.microsoft.com/en-us/library/azure/ad/graph/howto/azure-ad-graph-api-supported-queries-filters-and-paging-options#filter)
+