errors/errors.psm1
|
### functions for Errorhandling Function Get-NWWebException { [CmdletBinding()] [OutputType([int])] Param ( [System.Management.Automation.ErrorRecord]$ExceptionMessage ) $type = $MyInvocation.MyCommand.Name -replace "Get-","" -replace "WebException","" switch -Wildcard ($ExceptionMessage.FullyQualifiedErrorId) { "*System.UriFormatException,Microsoft.PowerShell.Commands.Invoke*Command*" { Write-Host -ForegroundColor Magenta "$($ExceptionMessage.Exception.Message)" write-Host "Most likely you are not connected to the Networker Server" write-Host "please use Connect-NWServer to connect and login to Networker" } "*WebCmdletWebResponseException,Microsoft.PowerShell.Commands.Invoke*Command*" { switch -Wildcard ($ExceptionMessage.Exception) { "*SSL/TLS secure channel*" { Write-Host -ForegroundColor Magenta $ExceptionMessage Write-Host -ForegroundColor White "SSL/TLS secure channel error indicates untrasted certificates. Connect using -trustCert Option with Connect-Nwserver !" } "*400*" { Write-Host -ForegroundColor Magenta $ExceptionMessage Write-Host -ForegroundColor White "400 Bad Request Badly formed URI, parameters, headers, or body content. Essentially a request syntax error or a networker ressource (host. policy etc ) not found" } "*401*" { Write-Host -ForegroundColor Magenta $ExceptionMessage Write-Host -ForegroundColor White "Session expired or wrong User/Password ?" } "*403*" { Write-Host -ForegroundColor Magenta $ExceptionMessage Write-Host -ForegroundColor White "Authorization failed due to inadequate privileges for the NetWorker user to perform the specific operation. Ensure that the authenticating user to the NetWorker API service has the appropriate User Group privileges to perform this operation." } "*404*" { Write-Host -ForegroundColor Magenta $ExceptionMessage Write-Host -ForegroundColor White "404 Not Found Resource doesn't exist - either an invalid type name for instances list (GET, POST) or an invalid ID for a specific instance (GET, POST /action)" } "*405*" { Write-Host -ForegroundColor Magenta $ExceptionMessage Write-Host -ForegroundColor White "405 Method Not Allowed This code will be returned if you try to use a method that is not documented as a supported method." } "*406*" { Write-Host -ForegroundColor Magenta $ExceptionMessage Write-Host -ForegroundColor White "406 Not Acceptable Accept headers do not meet requirements (for example, output format, version,language) " } "*409*" { Write-Host -ForegroundColor Magenta $ExceptionMessage Write-Host -ForegroundColor White "409 Conflict The request could not be completed due to a conflict with the current state of the resource. This code is only allowed in situations where it is expected that the usermight be able to resolve the conflict and resubmit the request. The response body SHOULD include enough information for the user to correct the issue." } "*422*" { Write-Host -ForegroundColor Magenta $ExceptionMessage Write-Host -ForegroundColor White "422 Unprocessable Entity Semantically invalid content on a POST, which could be a range error, inconsistent properties, or something similar" } "*428*" { Write-Host -ForegroundColor Magenta $ExceptionMessage Write-Host -ForegroundColor White "Most likely this signals an unconfigured MDM or unapproved Certificates" } "*500*" { Write-Host -ForegroundColor Magenta $ExceptionMessage Write-Host -ForegroundColor White "500 Internal Server Error This code is returned for internal errors - file an AR. It also is returned in some platform management cases when PAPI cannot return a decent error. Best practice is to avoid filing an AR. " } "*501*" { Write-Host -ForegroundColor Magenta $ExceptionMessage Write-Host -ForegroundColor White "501 Not Implemented Not currently used" } "*503*" { Write-Host -ForegroundColor Magenta $ExceptionMessage Write-Host -ForegroundColor White "503 Service Unavailable" } default { Write-Host -ForegroundColor White "general web error" $_ | fl * } } } default { Write-Host -ForegroundColor Cyan "error not yet declared" Write-Warning "'$($ExceptionMessage.InvocationInfo.InvocationName) ' Calling Position: $($ExceptionMessage.InvocationInfo.PositionMessage) $($ExceptionMessage.FullyQualifiedErrorId)" } } } |