autographps-sdk

0.12.0

AutoGraphPS-SDK.psd1

                                #

# Module manifest for module 'AutoGraphPS-SDK'

#

# Generated by: adamedx

#

# Generated on: 9/24/2017

#

@{

# Script module or binary module file associated with this manifest.

RootModule = 'autographps-sdk.psm1'

# Version number of this module.

ModuleVersion = '0.12.0'

# Supported PSEditions

CompatiblePSEditions = @('Desktop', 'Core')

# ID used to uniquely identify this module

GUID = '4d32f054-da30-4af7-b2cc-af53fb6cb1b6'

# Author of this module

Author = 'Adam Edwards'

# Company or vendor of this module

CompanyName = 'Modulus Group'

# Copyright statement for this module

Copyright = '(c) 2019 Adam Edwards.'

# Description of the functionality provided by this module

Description = 'PowerShell SDK for automating the Microsoft Graph'

# Minimum version of the Windows PowerShell engine required by this module

PowerShellVersion = '5.1'

# Name of the Windows PowerShell host required by this module

# PowerShellHostName = ''

# Minimum version of the Windows PowerShell host required by this module

# PowerShellHostVersion = ''

# Minimum version of Microsoft .NET Framework required by this module. This prerequisite is valid for the PowerShell Desktop edition only.

# DotNetFrameworkVersion = ''

# Minimum version of the common language runtime (CLR) required by this module. This prerequisite is valid for the PowerShell Desktop edition only.

# CLRVersion = ''

# Processor architecture (None, X86, Amd64) required by this module

# ProcessorArchitecture = ''

# Modules that must be imported into the global environment prior to importing this module

# RequiredModules = @()

# Assemblies that must be loaded prior to importing this module

# RequiredAssemblies = @()

# Script files (.ps1) that are run in the caller's environment prior to importing this module.

# ScriptsToProcess = @()

# Type files (.ps1xml) to be loaded when importing this module

# TypesToProcess = @()

# Format files (.ps1xml) to be loaded when importing this module

# FormatsToProcess = @()

# Modules to import as nested modules of the module specified in RootModule/ModuleToProcess

NestedModules = @(@{ModuleName='scriptclass';ModuleVersion='0.20.1';Guid='9b0f5599-0498-459c-9a47-125787b1af19'})

# Functions to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no functions to export.

FunctionsToExport = @(

    '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'

)

# Cmdlets to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no cmdlets to export.

CmdletsToExport = @()

# Variables to export from this module

VariablesToExport = @(

    'GraphVerboseOutputPreference'

    'LastGraphItems'

)

# Aliases to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no aliases to export.

AliasesToExport = @('gge', 'ggi')

# DSC resources to export from this module

# DscResourcesToExport = @()

# List of all modules packaged with this module

# ModuleList = @('')

# List of all files packaged with this module

    FileList = @(

        '.\AutoGraphPS-SDK.psd1'

        '.\autographps-sdk.psm1'

        '.\src\aliases.ps1'

        '.\src\cmdlets.ps1'

        '.\src\graph-sdk.ps1'

        '.\src\auth\AuthProvider.ps1'

        '.\src\auth\CompiledDeviceCodeAuthenticator.ps1'

        '.\src\auth\DeviceCodeAuthenticator.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\Find-GraphLocalCertificate.ps1'

        '.\src\cmdlets\Get-GraphApplication.ps1'

        '.\src\cmdlets\Get-GraphApplicationCertificate.ps1'

        '.\src\cmdlets\Get-GraphApplicationConsent.ps1'

        '.\src\cmdlets\Get-GraphApplicationServicePrincipal.ps1'

        '.\src\cmdlets\Get-GraphConnectionInfo.ps1'

        '.\src\cmdlets\Get-GraphError.ps1'

        '.\src\cmdlets\Get-GraphItem.ps1'

        '.\src\cmdlets\Get-GraphToken.ps1'

        '.\src\cmdlets\Invoke-GraphRequest.ps1'

        '.\src\cmdlets\New-GraphApplication.ps1'

        '.\src\cmdlets\New-GraphApplicationCertificate.ps1'

        '.\src\cmdlets\New-GraphConnection.ps1'

        '.\src\cmdlets\New-GraphLocalCertificate.ps1'

        '.\src\cmdlets\Register-GraphApplication.ps1'

        '.\src\cmdlets\Remove-GraphApplication.ps1'

        '.\src\cmdlets\Remove-GraphApplicationCertificate.ps1'

        '.\src\cmdlets\Remove-GraphApplicationConsent.ps1'

        '.\src\cmdlets\Remove-GraphItem.ps1'

        '.\src\cmdlets\Set-GraphApplicationConsent.ps1'

        '.\src\cmdlets\Set-GraphConnectionStatus.ps1'

        '.\src\cmdlets\Test-Graph.ps1'

        '.\src\cmdlets\Unregister-GraphApplication.ps1'

        '.\src\cmdlets\common\ApplicationHelper.ps1'

        '.\src\cmdlets\common\CommandContext.ps1'

        '.\src\cmdlets\common\ConsentHelper.ps1'

        '.\src\cmdlets\common\DisplayTypeFormatter.ps1'

        '.\src\cmdlets\common\DynamicParamHelper.ps1'

        '.\src\cmdlets\common\GraphOutputFile.ps1'

        '.\src\cmdlets\common\ItemResultHelper.ps1'

        '.\src\cmdlets\common\ParameterCompleter.ps1'

        '.\src\cmdlets\common\PermissionParameterCompleter.ps1'

        '.\src\cmdlets\common\QueryHelper.ps1'

        '.\src\common\DefaultScopeData.ps1'

        '.\src\common\GraphAccessDeniedException.ps1'

        '.\src\common\GraphApplicationCertificate.ps1'

        '.\src\common\GraphUtilities.ps1'

        '.\src\common\PreferenceHelper.ps1'

        '.\src\common\ProgressWriter.ps1'

        '.\src\common\ScopeHelper.ps1'

        '.\src\common\Secret.ps1'

        '.\src\graphservice\ApplicationAPI.ps1'

        '.\src\graphservice\ApplicationObject.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'

    )

# Private data to pass to the module specified in RootModule/ModuleToProcess. This may also contain a PSData hashtable with additional module metadata used by PowerShell.

PrivateData = @{

    PSData = @{

        # Tags applied to this module. These help with module discovery in online galleries.

        Tags = @('MSGraph', 'Graph', 'AADGraph', 'Azure', 'MicrosoftGraph', 'Microsoft-Graph', 'MS-Graph', 'AAD-Graph', 'REST', 'CRUD', 'GraphAPI', 'poshgraph', 'poshgraph-sdk', 'autograph', 'PSEdition_Core', 'PSEdition_Desktop', 'Windows', 'Linux', 'MacOS')

        # A URL to the license for this module.

        LicenseUri = 'http://www.apache.org/licenses/LICENSE-2.0'

        # A URL to the main website for this project.

        ProjectUri = 'https://github.com/adamedx/poshgraph-sdk'

        # A URL to an icon representing this module.

        IconUri = 'https://raw.githubusercontent.com/adamedx/poshgraph-sdk/master/assets/PoshGraphIcon.png'

        # Adds pre-release to the patch version according to the conventions of https://semver.org/spec/v1.0.0.html

        # Requires PowerShellGet 1.6.0 or greater

        # Prerelease = '-preview'

        # ReleaseNotes of this module

        ReleaseNotes = @'

# 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.

'@

    } # End of PSData hashtable

} # End of PrivateData hashtable

# HelpInfo URI of this module

# HelpInfoURI = ''

# Default prefix for commands exported from this module. Override the default prefix using Import-Module -Prefix.

# DefaultCommandPrefix = ''

}