The friendly, scriptable Graph Explorer CLI for automating the Microsoft Graph

Minimum PowerShell version


Installation Options

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

Install-Module -Name autographps -RequiredVersion 0.37.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


Adam Edwards


(c) 2021 Adam Edwards.

Package Details



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


Add-GraphRelatedItem Find-GraphPermission Find-GraphType Get-Graph Get-GraphChildItem Get-GraphItem Get-GraphItemRelationship Get-GraphItemUri Get-GraphLastOutput Get-GraphLocation Get-GraphMember Get-GraphMethod Get-GraphRelatedItem Get-GraphResourceWithMetadata Get-GraphType Get-GraphUri Get-GraphUriInfo Invoke-GraphMethod Measure-Graph New-Graph New-GraphItem New-GraphItemRelationship New-GraphMethodParameterObject New-GraphObject Remove-Graph Remove-GraphItem Remove-GraphItemRelationship Set-GraphItem Set-GraphLocation Set-GraphPrompt Show-GraphHelp Update-GraphMetadata


Core Desktop


Release Notes

## AutoGraphPS 0.37.0 Release Notes

Bug fixes and updates to support profiles, color, and other usability improvements

### New dependencies

* `autographps-sdk 0.26.0`

### Breaking changes

* See breaking changes from `autographps-sdk 0.26.0`
* The `Get-GraphStatistics` command has been renamed to `Measure-Graph`
* When positional binding is used with the following commands, those positional parameters  no long bind to the `Uri` parameter, but to the `Type` and then `Id`, `Property`, and `Value` parameters. To bind by URI, the `-Uri` parameter must be specified explicitly by name. This any use of these commands with positional binding will now break:
 * `Get-GraphItem`
 * `Set-GraphItem`
 * `Remove-Graphitem`
* The pipeline parameter binding has been changed for `Get-GraphChildItem` and `Get-GraphResourceWithMetadata` (aka through the `gls` alias), though in general the binding is more permissive and may not break at all or may break in subtle ways
* The `ggreli` alias for `Get-GraphRelatedItem` is now `gri`
* The `Set-GraphPrompt` command no longer as the `Enabled` and `Disabled` parameters
 * Instead, the new `Behavior` parameter which is also a positional parameter supports the values `Disable` and `Enable` which correspond to setting the `Disabled` and `Enabled` parameters of the previous version of this command. The default value is `Auto`, which allows the prompt behavior to be controlled by the module according to the current location managed by `Set-GraphLocation`.

### New features

* Configuration (enabled by autographps-sdk): the module now supports "Profile settings". It reads the file `~/.autographps/settings.json` on module load if it exists and sets behaviors including the initial connection according to the settings expressed in the configuration file
 * The following settings specific to this module are now configurable from the `settings.json` file:
   * `PromptBehavior`: Set this to the same values as the `Behavior` parameter of `Set-GraphPrompt` to control the behavior of the prompt
   * `PromptColor`: Sets the color of the prompt -- supports the same values and behaviors as the `GraphPromptColorPreference` perference variable
 * From autographps-sdk: The following commands related to the proflie settings feature have been added:
   * `Get-GraphProfileSettings`
   * `Select-GraphProfileSettings`
   * `Get-GraphConnection`: enumerates 'named' connections created by `New-GraphConnection` or profile settings
   * `Remove-GraphConnection`: remove named connections
* Many commands have improved terminal output formatting for both table and list formats
* Many commands, including common commands like `gls` now have color support!
* Output of `Get-GraphResourceWithMetadata` / `gls` can now be piped to `Get-GraphMember` and `Get-GraphType`.
* `Get-GraphResourceWithMetadata` / `gls` supports a `Count` parameter that returns just the count of items that would be returned
* New `Get-GraphLastOutput` command that returns the last results from previous commands and associates them with an index.
* The `Set-GraphLocation` command, aka `gcd` supports a new `Index` parameter that refers to the item with that index returned by `Get-GraphLastOutput`; by specifying this index, the command can change the current location to the location of the result with that index. This is useful for
* The `guri` alias has been added for `Get-GraphUri`
* The output of `Get-GraphMember`, `Get-GraphType`, and `Get-GraphMethod` is now grouped
* Fix broken `Members` value for the `Criteria` parameter of `Find-GraphType`

### Fixed defects

* Fixed some crashes caused by namespace aliases
* Fixed issues handling times with the `Get-Graph` command
* Fixed invalid return types for non-entity types for actions and functions


Version History

Version Downloads Last updated
0.42.0 32 2/19/2023
0.41.0 372 12/30/2021
0.40.0 259 10/26/2021
0.39.0 216 10/20/2021
0.38.0 289 6/14/2021
0.37.1 234 5/5/2021
0.37.0 (current version) 216 5/5/2021
0.36.0 235 2/27/2021
0.35.0 251 9/26/2020
0.34.0 209 9/26/2020
0.33.0 209 9/26/2020
0.32.1 254 6/20/2020
0.32.0 223 5/24/2020
0.31.0 253 2/4/2020
0.30.0 218 2/1/2020
0.29.0 289 11/6/2019
0.28.0 232 10/24/2019
0.27.0 216 10/23/2019
0.26.0 225 10/16/2019
0.25.0 220 10/7/2019
0.24.0 218 9/24/2019
0.23.0 308 3/18/2019
0.22.0 260 2/3/2019
0.21.1 230 1/19/2019
0.21.0 226 1/14/2019
0.20.0 228 1/8/2019
0.19.0 224 1/7/2019
0.18.2 222 1/6/2019
0.18.1 222 1/5/2019
0.18.0 223 1/4/2019
0.17.0 225 1/2/2019
0.16.1 247 10/30/2018
0.16.0 233 10/15/2018
0.15.1 229 9/30/2018
0.15.0 224 9/24/2018
0.14.0 227 9/16/2018
Show less