autographps-sdk

0.12.0

PowerShell SDK for automating the Microsoft Graph

Minimum PowerShell version

5.1

Installation Options

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

Install-Module -Name autographps-sdk -RequiredVersion 0.12.0

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

Install-PSResource -Name autographps-sdk -Version 0.12.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) 2019 Adam Edwards.

Package Details

Author(s)

  • Adam Edwards

Tags

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

Functions

Connect-Graph Disconnect-Graph Find-GraphLocalCertificate Get-GraphApplication Get-GraphApplicationCertificate Get-GraphApplicationConsent Get-GraphApplicationServicePrincipal Get-GraphConnectionInfo Get-GraphError Get-GraphItem Get-GraphToken Invoke-GraphRequest New-GraphApplication New-GraphApplicationCertificate New-GraphConnection New-GraphLocalCertificate Register-GraphApplication Remove-GraphApplication Remove-GraphApplicationCertificate Remove-GraphApplicationConsent Remove-GraphItem Set-GraphApplicationConsent Set-GraphConnectionStatus Test-Graph Unregister-GraphApplication

PSEditions

Core Desktop

Dependencies

Release Notes

# AutoGraphPS-SDK 0.12.0 Release Notes

This release fixes defects introduced by the previous `0.11.1` release and includes some minor feature updates.

## New dependencies
None.

## Breaking changes
None.

## New features

* Added the `ReplyUrl` alias to the `AppRedirectUri` parameter of `Get-GraphToken`, `Connect-Graph` and `New-GraphConnection`
* `Get-GraphConnectionInfo` now includes a connection id guid property in its output to identify each unique connection

## Fixed defects

* `Test-Graph` command regression prevented targeting clouds other than `Public`
* `Get-GraphToken`, `Connect-Graph` and `New-GraphConnection` regressions caused certain parameter sets to require all parameters
* Fix race condition with `Connect-Graph` due to MSAL changes with integrated token cache: `Connect-Graph` created
 a new token, which was immediately invalidated, requiring a reconnect when used with a command.
* Fix error output from `Get-GraphToken` due to missing `GraphResourceUri` parameter, which also blocked alternate resource uri functionality

### Miscellaneous implementation notes

The most involved fix was to address a defect introduced when the `MSAL` library version was updated to `4.4.0`. Prior to this release, token caches were maintained independently from the `PublicClientApplication` or `ConfidentialClientApplication` authentication context.

With `MSAL` `4.4.0`, token caches were part of the authentication context. When `4.4.0` was integrated into `AutoGraphPS-SDK`, this change was accounted for, but there was still an assumption that the authentication context could be shared across the `AutoGraphPS-SDK` notion of `Connection` without the cache being affected by the sharing. Since cache had become part of the auth context, sharing the auth context as `AutoGraphPS-SDK` had always done for a given connection meant sharing caches; this introduced race conditions where a token could be added to a cache only to have it immediately removed by an operation that was assumed to be independent of that cache but wasn't. The result was that users would someitmes be requested to sign-in again immediately after a sign-in prompted by `Connect-Graph` or any command that affected connection management.

The fix was to ensure each connection used a separate authentication context by associating each auth context with a connection in a store of auth contexts. A better fix may be to remove the store of auth contexts altogether, and make the auth context part of the connection itself, or at least simplify the lookup logic to use only the connection id.

FileList

Version History

Version Downloads Last updated
0.31.0 314 9/2/2024
0.30.0 368 2/19/2023
0.29.0 727 12/30/2021
0.28.0 559 10/12/2021
0.27.0 555 6/13/2021
0.26.1 469 5/5/2021
0.26.0 438 5/4/2021
0.25.0 458 2/27/2021
0.24.0 590 9/26/2020
0.23.0 394 9/26/2020
0.22.0 440 9/8/2020
0.21.1 595 6/20/2020
0.21.0 484 5/24/2020
0.20.0 792 4/19/2020
0.19.0 624 4/12/2020
0.18.0 1,165 2/8/2020
0.17.0 625 1/29/2020
0.16.0 719 11/6/2019
0.15.0 453 10/24/2019
0.14.0 417 10/23/2019
0.13.0 426 10/16/2019
0.12.0 (current version) 421 10/7/2019
0.11.1 489 9/23/2019
0.11.0 401 9/20/2019
0.10.0 596 3/18/2019
0.9.0 632 2/3/2019
0.8.1 417 1/19/2019
0.8.0 415 1/13/2019
0.7.1 423 1/8/2019
0.7.0 407 1/8/2019
0.6.2 413 1/6/2019
0.6.1 410 1/5/2019
0.6.0 413 1/2/2019
0.5.1 458 10/30/2018
0.5.0 458 9/30/2018
0.4.0 432 9/15/2018
Show less