autographps

0.16.0

CLI for automating the Microsoft Graph

Installation Options

Copy and Paste the following command to install this package using PowerShellGet More Info

Install-Module -Name autographps -RequiredVersion 0.16.0

Copy and Paste the following command to install this package using Microsoft.PowerShell.PSResourceGet More Info

Install-PSResource -Name autographps -Version 0.16.0

You can deploy this package directly to Azure Automation. Note that deploying packages with dependencies will deploy all the dependencies to Azure Automation. Learn More

Manually download the .nupkg file to your system's default download location. Note that the file won't be unpacked, and won't include any dependencies. Learn More

Owners

Copyright

(c) 2018 Adam Edwards.

Package Details

Author(s)

  • Adam Edwards

Tags

MSGraph Graph AADGraph Azure MicrosoftGraph Microsoft-Graph MS-Graph AAD-Graph GraphExplorer REST CRUD GraphAPI autograph poshgraph

Cmdlets

Get-Graph Get-GraphChildItem Get-GraphLocation Get-GraphType Get-GraphUri New-Graph Remove-Graph Set-GraphLocation Set-GraphPrompt Update-GraphMetadata

Dependencies

Release Notes

# AutoGraphPS 0.16.0 Release Notes

This release changes the user experience of schema processing, which originally took place in the background and required around 2 minutes or more after the module was loaded to complete. This mean that cmdlets such as `Get-GraphChildItem` and `Set-GraphLocation` that depended on metadata would hang until processing was done, or would need to skip metadata processing and return incomplete results.

With this release, the following changes are introduced:

* The only background processing done now is metadata download -- previously the entire model was traversed to construct a graph in the background, this is no longer the case.
* Only when cmdlets that require metadata are invoked, e.g. `Get-GraphChild`, is metadata accessed, and then only the minimal amount of metadata require for that command is processed. So in a graph with 1000 vertices, if only one vertex is required to satisfy the cmdlet, only that one vertex is processed. This can be referred to as *on-demand* or *just-in-time* metadata processing.
* Serialization overhead from moving the processed graph from a background job to the current session is eliminated because processing only occurs in the current session -- this can save anywhere from a 2-3s to 10s on first-time metadata cmdlet invocation.
* Several inefficiencies in metadata processing were addressed, such as enumerating every action and function (around 500 of these!) every time a type vertex was processed
* Workarounds for limitations in PowerShell serialization of `PSCustomObject` types where some metadata was processed in the background and other metadata in the foreground (as was the case for the `beta` API version due to its greater serialization depth than `v1.0`) are no longer needed and were removed as all processing is done in the foreground and there is no serialization done as part of metadata processing.
* The caching layer above the `EntityGraph` still exists, so the just-in-time processing occurs only once for a particular part of the Graph as was previously the case.

The resulting user experience is the following:

* Upon module load, metadata is ready in 10s or less
* Even if you run a metadata cmdlet immediately on loading (or to trigger loading) the module, this first invocation will complete in under 10s if you specify to wait for metadata, or you can simply try again and in the first 1-2 retries the cmdlet will complete normally
* There will be a slight delay (~1s) the first time a part of the Graph is accessed to accommodate just-in-time metadata processing, but only on that first access
* There will no longer be sustained high CPU utilization (around 2 minutes) on module startup
* In general, the module will feel "snappier" in terms of starting up and getting going with cmdlets.
* The improvement also comes into play when mounting new API versions.

## New Features

None.

## New dependencies

None.

## Fixed defects

* [Beta version schema parsing encounters deserialization error](https://github.com/adamedx/autographps/issues/27)
* [Schema parsing takes more than 2 minutes, affects get-graphuri, set-graphlocation etc. ](https://github.com/adamedx/autographps/issues/26)

FileList

Version History

Version Downloads Last updated
0.44.0 470 11/11/2024
0.43.0 26 9/5/2024
0.42.0 372 2/19/2023
0.41.0 378 12/30/2021
0.40.0 265 10/26/2021
0.39.0 222 10/20/2021
0.38.0 295 6/14/2021
0.37.1 240 5/5/2021
0.37.0 222 5/5/2021
0.36.0 241 2/27/2021
0.35.0 257 9/26/2020
0.34.0 215 9/26/2020
0.33.0 215 9/26/2020
0.32.1 260 6/20/2020
0.32.0 229 5/24/2020
0.31.0 259 2/4/2020
0.30.0 224 2/1/2020
0.29.0 295 11/6/2019
0.28.0 238 10/24/2019
0.27.0 222 10/23/2019
0.26.0 231 10/16/2019
0.25.0 226 10/7/2019
0.24.0 224 9/24/2019
0.23.0 314 3/18/2019
0.22.0 266 2/3/2019
0.21.1 236 1/19/2019
0.21.0 232 1/14/2019
0.20.0 234 1/8/2019
0.19.0 230 1/7/2019
0.18.2 228 1/6/2019
0.18.1 228 1/5/2019
0.18.0 229 1/4/2019
0.17.0 231 1/2/2019
0.16.1 253 10/30/2018
0.16.0 (current version) 239 10/15/2018
0.15.1 235 9/30/2018
0.15.0 230 9/24/2018
0.14.0 233 9/16/2018
Show less