poshgraph-sdk
0.3.0-preview
PowerShell SDK for Microsoft Graph interaction
Minimum PowerShell version
5.0
Installation Options
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
-
- scriptclass (>= 0.13.7)
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`, `Get-GraphChildItem` 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
- poshgraph-sdk.nuspec
- poshgraph-sdk.psd1
- poshgraph-sdk.psm1
- lib\Microsoft.Identity.Client.1.1.4-preview0002\lib\net45\Microsoft.Identity.Client.dll
- lib\Microsoft.Identity.Client.1.1.4-preview0002\lib\net45\Microsoft.Identity.Client.xml
- lib\Microsoft.IdentityModel.Clients.ActiveDirectory.3.19.0\lib\net45\Microsoft.IdentityModel.Clients.ActiveDirectory.dll
- lib\Microsoft.IdentityModel.Clients.ActiveDirectory.3.19.0\lib\net45\Microsoft.IdentityModel.Clients.ActiveDirectory.Platform.dll
- lib\Microsoft.IdentityModel.Clients.ActiveDirectory.3.19.0\lib\net45\Microsoft.IdentityModel.Clients.ActiveDirectory.Platform.xml
- lib\Microsoft.IdentityModel.Clients.ActiveDirectory.3.19.0\lib\net45\Microsoft.IdentityModel.Clients.ActiveDirectory.xml
- src\aliases.ps1
- src\cmdlets.ps1
- src\graph-sdk.ps1
- src\auth\AuthProvider.ps1
- src\auth\V1AuthProvider.ps1
- src\auth\V2AuthProvider.ps1
- src\client\Application.ps1
- src\client\graphapplication.ps1
- src\client\GraphConnection.ps1
- src\client\GraphContext.ps1
- src\client\GraphIdentity.ps1
- src\client\LogicalGraphManager.ps1
- src\cmdlets\connect-graph.ps1
- src\cmdlets\disconnect-graph.ps1
- src\cmdlets\Get-GraphConnectionStatus.ps1
- src\cmdlets\get-grapherror.ps1
- src\cmdlets\get-graphitem.ps1
- src\cmdlets\Get-GraphSchema.ps1
- src\cmdlets\Get-GraphToken.ps1
- src\cmdlets\Get-GraphVersion.ps1
- src\cmdlets\Invoke-GraphRequest.ps1
- src\cmdlets\New-GraphConnection.ps1
- src\cmdlets\Set-GraphConnectionStatus.ps1
- src\cmdlets\Test-Graph.ps1
- src\cmdlets\common\DynamicParamHelper.ps1
- src\cmdlets\common\ItemResultHelper.ps1
- src\cmdlets\common\QueryHelper.ps1
- src\common\GraphAccessDeniedException.ps1
- src\common\GraphUtilities.ps1
- src\common\PreferenceHelper.ps1
- src\common\ProgressWriter.ps1
- src\common\ScopeHelper.ps1
- src\common\Secret.ps1
- src\graphservice\graphendpoint.ps1
- src\REST\GraphErrorRecorder.ps1
- src\REST\GraphRequest.ps1
- src\REST\GraphResponse.ps1
- src\REST\RestRequest.ps1
- src\REST\RestResponse.ps1
Version History
Version | Downloads | Last updated |
---|---|---|
0.3.2 | 732 | 9/22/2018 |
0.3.1 | 14 | 9/22/2018 |
0.3.0 | 32 | 9/9/2018 |
0.3.0-preview (current version) | 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 |