MSGraphPSEssentials.psd1

# Module manifest for module 'MSGraphPSEssentials'
# Generated by: Jeremy Bradshaw
# Generated on: 2022-01-12

@{
    RootModule           = 'MSGraphPSEssentials.psm1'
    ModuleVersion        = '0.6.0'
    CompatiblePSEditions = @('Desktop', 'Core')
    GUID                 = '7394f3f8-a172-4e18-8e40-e41295131e0b'
    Author               = 'Jeremy.Bradshaw@Outlook.com'
    CompanyName          = ''
    Copyright            = '(c) 2020 Jeremy Bradshaw. All rights reserved.'
    Description          = 'A collection of functions enabling easier consumption of Microsoft Graph using just PowerShell (Desktop/Core).'
    PowerShellVersion    = '5.1'
    FunctionsToExport    = @(
        'New-MSGraphAccessToken',
        'New-MSGraphRequest',
        'New-SelfSignedMSGraphApplicationCertificate',
        'New-MSGraphPoPToken',
        'Add-MSGraphApplicationKeyCredential',
        'Remove-MSGraphApplicationKeyCredential',
        'ConvertFrom-JWTAccessToken',
        'New-RefreshTokenCredential',
        'Get-AccessTokenExpiration'
    )
    CmdletsToExport      = @()
    VariablesToExport    = @()
    AliasesToExport      = @()
    PrivateData          = @{

        PSData = @{
            Tags         = @('MicrosoftGraph', 'OAuth', 'App-Only', 'Delegated', 'DeviceCode', 'JWT', 'AccessToken', 'RefreshToken')
            LicenseUri   = 'https://github.com/JeremyTBradshaw/MSGraphPSEssentials/blob/main/LICENSE'
            ProjectUri   = 'https://github.com/JeremyTBradshaw/MSGraphPSEssentials'
            ReleaseNotes = @'
v0.6.0 (2022-01-12):
 
- Updated New-MSGraphRequest to no longer be a recursive function in order to gracefully avoid call depth
    overflow, in the event that there are too many nextLink's (i.e., too may users to return in large orgs). It is
    still recommended to use the $top OData query option to set a larger page size to reduce the number of
    nextLink's required to fetch all results. This change just avoids any issues with call depth overflow,
    regardless of proactive/strategic $top usage.
 
- Updated New-MSGraphAccessToken so that it includes a new property in the output - 'issued_at'. This new
    property will be used by Get-AccessTokenExpiration.
 
- Updated Get-AccessTokenExpiration so that it does its check using the 'issued_at' and 'expires_in' properties
    from objects output by New-MSGraphAccessToken. This is being done because during a Microsoft Identity Platform
    webinar, I learned that Microsoft will soon begin encrypting all access tokens and that they should never be
    looked at by programs, including to determine when they'll expire. With the shimmmed-in 'issue_at' property,
    combined with the already-included expires_in property that comes with the access_token, we can still
    accomplish the same goal.
'@

        }
    }
    HelpInfoURI          = 'https://github.com/JeremyTBradshaw/MSGraphPSEssentials/blob/main/README.md'
}