poshgraph-sdk

0.3.0

PowerShell SDK for Microsoft Graph interaction

Minimum PowerShell version

5.0

Installation Options

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

Install-Module -Name poshgraph-sdk -RequiredVersion 0.3.0

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

Install-PSResource -Name poshgraph-sdk -Version 0.3.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 REST CRUD GraphAPI

Cmdlets

Connect-Graph Disconnect-Graph Get-GraphConnectionStatus Get-GraphError Get-GraphItem Get-GraphSchema Get-GraphToken Get-GraphVersion Invoke-GraphRequest New-GraphConnection Set-GraphConnectionStatus Test-Graph

Functions

Get-DynamicValidateSetParameter

Dependencies

Release Notes

# PoshGraph-SDK 0.3.0 Release Notes

This release adds support for app authentication and cmdlet argument completion.

## New features

### Cmdlet features
* V1 auth protocol token caching introduced -- no need to re-authenticate every hour for V1 auth
* App-only auth through `New-GraphConnection` for v1 and v2 auth protocols via symmetric key or certificate
 * Use `-NonInteractiveAppAuth` of `New-GraphConnection` for app only auth and specify one of the following options
   * `-Secret` to specify a symmetric key through the `-Password` parameter
   * `-CertificatePath` to specify a path to a ceritificate in the local certificate store PowerShell drive `cert:`.
   * `-Certificate` to specify an `X509Certificate2` describing an `X509` certificate with a private key such as one that can be obtained by reading a certificate from the local certificate store or from any number of serialized certificate file formats such as `.pfx`, `.cer`, etc.
 * The connection returned by `New-GraphConnection` can be supplied to the `-Connection` parameter of the `Connect-Graph` cmdlet or other cmdlets that accept the `-Connection` parameter obtain and use an app-only access token
* Argument completion for `ScopeNames` parameter of `Connect-Graph` and `New-GraphConnection` cmdlets
 * Associated `-SkipScopeValidation` option to allow scope names not validated / completed by the cmdlet
* Parameter `-GraphAuthProtocol` has been changed to `-AuthProtocol` for the `New-GraphConnection` cmdlet
* `-Search` option added to `Get-GraphItem` and `Invoke-GraphRequests` cmdlets to enable full-text search on Graph REST calls that support the OData `$search` query parameter

#### Feature notes
* For app-only auth: If `-Secret` is specified but `-Password` is not specified, you will receive a secure input prompt to allow you to implement the symmetric key password from the console.
* For the `-CertificatePath` parameter, if the specified path to the certificate in the PowerShell `cert:` drive is not an absolute path starting with `cert:/`, the path is assumed to be relative to the user's certificate story, i.e. `cert://currentuser/my`.

### Library features

* Expose tenant display information from the `GraphIdentity` class.
* Refactor of authentication related code

## Fixed defects

* Fix incorrect auth protocol used due to shared reference corruption issue in data structure
* Fix token cache not being cleared when connection was disconnected
* Fix confusing parameter sets for `New-GraphConnection` and `Connect-Graph` with simpler permutations

FileList

Version History

Version Downloads Last updated
0.3.2 732 9/22/2018
0.3.1 14 9/22/2018
0.3.0 (current version) 32 9/9/2018
0.3.0-preview 12 9/9/2018
0.2.0 40 8/23/2018
0.2.0-preview 13 8/23/2018
0.1.3 28 8/16/2018
0.1.2 14 8/16/2018
0.1.1 20 8/15/2018
Show more