Public/Get-AtwsWsdlVersion.ps1
|
<# .COPYRIGHT Copyright (c) Hugo Klemmestad. All rights reserved. Licensed under the MIT license. See https://github.com/ecitsolutions/Autotask/blob/master/LICENSE.md for license information. #> Function Get-AtwsWsdlVersion { <# .SYNOPSIS This function gets the current API version from the Autotask servers. .DESCRIPTION The function calls GetWsdlVersion() and returns the result. .INPUTS Nothing. .OUTPUTS ATWSResponse .EXAMPLE Get-AtwsWsdlVersion gets the current API version from the Autotask servers. .NOTES NAME: Get-AtwsWsdlVersion #> [cmdletbinding()] Param ( ) begin { # Enable modern -Debug behavior if ($PSCmdlet.MyInvocation.BoundParameters['Debug'].IsPresent) { $DebugPreference = 'Continue' } Write-Debug ('{0}: Begin of function' -F $MyInvocation.MyCommand.Name) if (-not($Script:Atws.integrationsValue)) { # Not connected. Try to connect, prompt for credentials if necessary Write-Verbose ('{0}: Not connected. Calling Connect-AtwsWebApi without parameters for possible autoload of default connection profile.' -F $MyInvocation.MyCommand.Name) Connect-AtwsWebAPI } } process { try { Write-Verbose ('{0}: Calling GetWsdlVersion()' -F $MyInvocation.MyCommand.Name) $result = $Script:Atws.GetWsdlVersion($Script:Atws.IntegrationsValue) } catch { throw (New-Object System.Net.WebException ('{0}: FAILED on GetWsdlVersion($Script:Atws.IntegrationsValue). No data returned.' -F $MyInvocation.MyCommand.Name)) Return } # Handle any errors if ($result.Errors.Count -gt 0) { foreach ($AtwsError in $result.Errors) { Write-Error $AtwsError.Message } Return } } end { Write-Debug ('{0}: End of function' -F $MyInvocation.MyCommand.Name) Return $result } } |