Private/New-MSGraphMailPOSTRequest.ps1
|
function New-MSGraphMailPOSTRequest { <# .SYNOPSIS Builds a POST request for the Microsoft Graph API. .DESCRIPTION Wrapper function to build web requests for the Microsoft Graph API. .OUTPUTS Outputs an object containing the response from the web request. #> [CmdletBinding()] [OutputType([Object])] [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseShouldProcessForStateChangingFunctions', '', Justification = 'Private function - no need to support.')] param ( # The request URI. [uri]$URI, # The content type for the request. [string]$ContentType, # The request body. [object]$Body, # Don't authenticate. [switch]$Anonymous, # Additional headers. [hashtable]$AdditionalHeaders = $null, # Return raw result? [switch]$Raw ) if ($null -eq $Script:MSGMConnectionInformation) { Throw "Missing Microsoft Graph connection information, please run 'Connect-MSGraphMail' first." } if ($null -eq $Script:MSGMAuthenticationInformation) { Throw "Missing Microsoft Graph authentication tokens, please run 'Connect-MSGraphMail' first." } try { $WebRequestParams = @{ Method = 'POST' Uri = $URI ContentType = $ContentType Anonymous = $Anonymous AdditionalHeaders = $AdditionalHeaders } if ($ContentType -like 'application/json*' -and $Body) { $WebRequestParams.Body = ConvertTo-Json -InputObject $Body -Depth 5 } if ($ContentType -eq 'text/plain' -and $Body) { $WebRequestParams.Body = $Body } Write-Debug "Building new Microsoft Graph POST request with body: $($WebRequestParams | Out-String -Width 5000)" Write-Verbose "Using Content-Type: $($WebRequestParams.ContentType)" $Result = Invoke-MSGraphWebRequest @WebRequestParams if ($Result) { if ($Raw) { Return $Result } else { Return $Result.content | ConvertFrom-Json -Depth 5 } } else { Throw 'No response to POST request' } } catch { New-MSGraphError $_ } } |