functions/get-d365restserviceoperation.ps1
|
<# .SYNOPSIS Get Service Group from the Json Service endpoint .DESCRIPTION Get available Service Group from the Json Service endpoint of the Dynamics 365 Finance & Operations instance .PARAMETER ServiceGroupName Name of the Service Group that you want to be working against .PARAMETER ServiceName Name of the Service that you want to be working against .PARAMETER OperationName Name of the Operation that you are looking for The parameter supports wildcards. E.g. -OperationName "*Get*" Default value is "*" to list all operations from the specific Service Group and Service combination .PARAMETER Tenant Azure Active Directory (AAD) tenant id (Guid) that the D365FO environment is connected to, that you want to access .PARAMETER Url URL / URI for the D365FO environment you want to access If you are working against a D365FO instance, it will be the URL / URI for the instance itself If you are working against a D365 Talent / HR instance, this will have to be "http://hr.talent.dynamics.com" .PARAMETER SystemUrl URL / URI for the D365FO instance where the Json Service endpoint is available If you are working against a D365FO instance, it will be the URL / URI for the instance itself, which is the same as the Url parameter value If you are working against a D365 Talent / HR instance, this will to be full instance URL / URI like "https://aos-rts-sf-b1b468164ee-prod-northeurope.hr.talent.dynamics.com/namespaces/0ab49d18-6325-4597-97b3-c7f2321aa80c" .PARAMETER ClientId The ClientId obtained from the Azure Portal when you created a Registered Application .PARAMETER ClientSecret The ClientSecret obtained from the Azure Portal when you created a Registered Application .PARAMETER Token Pass a bearer token string that you want to use for while working against the endpoint This can improve performance if you are iterating over a large collection/array .PARAMETER EnableException This parameters disables user-friendly warnings and enables the throwing of exceptions This is less user friendly, but allows catching exceptions in calling scripts .PARAMETER RawOutput Instructs the cmdlet to include the outer structure of the response received from Json Service endpoint The output will still be a PSCustomObject .PARAMETER OutputAsJson Instructs the cmdlet to convert the output to a Json string .EXAMPLE PS C:\> Get-D365RestServiceOperation -ServiceGroupName "BIServices" -ServiceName "SRSFrameworkService" This will list all available Operations from the Service Group "DMFService" and ServiceName "SRSFrameworkService" combinantion, from the Dynamics 365 Finance & Operations instance. It will use the default configuration details that are stored in the configuration store. Sample output: ServiceGroupName ServiceName OperationName ---------------- ----------- ------------- BIServices SRSFrameworkService addReportServerConfiguration BIServices SRSFrameworkService clearReportRDLCache BIServices SRSFrameworkService getAccountsForBrowserRole BIServices SRSFrameworkService getAosUtcNow BIServices SRSFrameworkService getApplicationObjectServers BIServices SRSFrameworkService getAssemblies .EXAMPLE PS C:\> Get-D365RestServiceOperation -ServiceGroupName "BIServices" -ServiceName "SRSFrameworkService" -OperationName "*report*" This will list all available Operations from the Service Group "DMFService" and ServiceName "SRSFrameworkService" combinantion, which macthes the pattern "*report*", from the Dynamics 365 Finance & Operations instance. It will use the default configuration details that are stored in the configuration store. Sample output: ServiceGroupName ServiceName OperationName ---------------- ----------- ------------- BIServices SRSFrameworkService addReportServerConfiguration BIServices SRSFrameworkService clearReportRDLCache BIServices SRSFrameworkService getReportDataSources BIServices SRSFrameworkService getReportDesigns BIServices SRSFrameworkService getReportDetails BIServices SRSFrameworkService getReportFullPath .EXAMPLE PS C:\> Get-D365RestServiceGroup -Name "BIServices" | Get-D365RestService | Get-D365RestServiceOperation This will list all available Service Groups, which matches the "BIServices" pattern, from the Dynamics 365 Finance & Operations instance. It will pipe all Service Groups into the Get-D365RestService cmdlet, and pipe all Services available into the Get-D365RestServiceOperation cmdlet. It will use the default configuration details that are stored in the configuration store. Sample output: ServiceGroupName ServiceName OperationName ---------------- ----------- ------------- BIServices SRSFrameworkService addReportServerConfiguration BIServices SRSFrameworkService clearReportRDLCache BIServices SRSFrameworkService getAccountsForBrowserRole BIServices SRSFrameworkService getAosUtcNow BIServices SRSFrameworkService getApplicationObjectServers BIServices SRSFrameworkService getAssemblies .EXAMPLE PS C:\> $token = Get-D365ODataToken PS C:\> Get-D365RestServiceOperation -ServiceGroupName "BIServices" -ServiceName "SRSFrameworkService" -Token $token This will list all available Operations from the Service Group "DMFService" and ServiceName "SRSFrameworkService" combinantion, from the Dynamics 365 Finance & Operations instance. It will get a fresh token, saved it into the token variable and pass it to the cmdlet. It will use the default configuration details that are stored in the configuration store. Sample output: ServiceGroupName ServiceName OperationName ---------------- ----------- ------------- BIServices SRSFrameworkService addReportServerConfiguration BIServices SRSFrameworkService clearReportRDLCache BIServices SRSFrameworkService getAccountsForBrowserRole BIServices SRSFrameworkService getAosUtcNow BIServices SRSFrameworkService getApplicationObjectServers BIServices SRSFrameworkService getAssemblies .LINK Add-D365ODataConfig .LINK Get-D365ActiveODataConfig .LINK Set-D365ActiveODataConfig .NOTES Tags: OData, Data, Entity, Query Author: Mötz Jensen (@Splaxi) #> function Get-D365RestServiceOperation { [CmdletBinding(DefaultParameterSetName = "Default")] [OutputType()] param ( [Parameter(Mandatory = $true, ValueFromPipeline = $true, ValueFromPipelineByPropertyName = $true)] [string] $ServiceGroupName, [Parameter(Mandatory = $true, ValueFromPipeline = $true, ValueFromPipelineByPropertyName = $true)] [string] $ServiceName, [string] $OperationName = "*", [Alias('$AadGuid')] [string] $Tenant = $Script:ODataTenant, [Alias('Uri')] [string] $Url = $Script:ODataUrl, [string] $SystemUrl = $Script:ODataSystemUrl, [string] $ClientId = $Script:ODataClientId, [string] $ClientSecret = $Script:ODataClientSecret, [string] $Token, [switch] $EnableException, [switch] $RawOutput, [switch] $OutputAsJson ) begin { if ([System.String]::IsNullOrEmpty($SystemUrl)) { Write-PSFMessage -Level Verbose -Message "The SystemUrl parameter was empty, using the Url parameter as the OData endpoint base address." -Target $SystemUrl $SystemUrl = $Url } if ([System.String]::IsNullOrEmpty($Url) -or [System.String]::IsNullOrEmpty($SystemUrl)) { $messageString = "It seems that you didn't supply a valid value for the Url parameter. You need specify the Url parameter or add a configuration with the <c='em'>Add-D365ODataConfig</c> cmdlet." Write-PSFMessage -Level Host -Message $messageString -Exception $PSItem.Exception -Target $entityName Stop-PSFFunction -Message "Stopping because of errors." -Exception $([System.Exception]::new($($messageString -replace '<[^>]+>', ''))) -ErrorRecord $_ return } if ($Url.Substring($Url.Length - 1) -eq "/") { Write-PSFMessage -Level Verbose -Message "The Url parameter had a tailing slash, which shouldn't be there. Removing the tailling slash." -Target $Url $Url = $Url.Substring(0, $Url.Length - 1) } if ($SystemUrl.Substring($SystemUrl.Length - 1) -eq "/") { Write-PSFMessage -Level Verbose -Message "The SystemUrl parameter had a tailing slash, which shouldn't be there. Removing the tailling slash." -Target $Url $SystemUrl = $SystemUrl.Substring(0, $SystemUrl.Length - 1) } if (-not $Token) { $bearerParms = @{ Url = $Url ClientId = $ClientId ClientSecret = $ClientSecret Tenant = $Tenant } $bearer = New-BearerToken @bearerParms } else { $bearer = $Token } $headerParms = @{ URL = $Url BearerToken = $bearer } $headers = New-AuthorizationHeaderBearerToken @headerParms } process { Invoke-TimeSignal -Start Write-PSFMessage -Level Verbose -Message "Building request for the Json Services endpoint" [System.UriBuilder] $restEndpoint = $SystemUrl if ($restEndpoint.Path -eq "/") { $restEndpoint.Path = "api/services/$ServiceGroupName/$ServiceName" } else { $restEndpoint.Path += "/api/services/$ServiceGroupName/$ServiceName" } $params = @{ } $params.Uri = $restEndpoint.Uri.AbsoluteUri $params.Headers = $headers $params.ContentType = "application/json" $params.Method = "GET" try { Write-PSFMessage -Level Verbose -Message "Executing http request against the REST endpoint." -Target $($restEndpoint.Uri.AbsoluteUri) $res = Invoke-RestMethod @params if (-not $RawOutput) { $res = $res.Operations | Where-Object { $_.Name -Like $OperationName -or $_.Name -eq $OperationName } | Sort-Object Name } else { $res.Operations = @($res.Operations | Where-Object { $_.Name -Like $OperationName -or $_.Name -eq $OperationName }) | Sort-Object Name } $obj = [PSCustomObject]@{ ServiceGroupName = $ServiceGroupName; ServiceName = $ServiceName } #Hack to silence the PSScriptAnalyzer $obj | Out-Null $res = $res | Select-PSFObject "ServiceGroupName from obj", "ServiceName from obj", "Name as OperationName" if ($OutputAsJson) { $res | ConvertTo-Json -Depth 10 } else { $res } } catch { $messageString = "Something went wrong while importing data through the REST endpoint for the entity: $ServiceName" Write-PSFMessage -Level Host -Message $messageString -Exception $PSItem.Exception -Target $ServiceName Stop-PSFFunction -Message "Stopping because of errors." -Exception $([System.Exception]::new($($messageString -replace '<[^>]+>', ''))) -ErrorRecord $_ return } Invoke-TimeSignal -End } } |