Public/Get-DokuServerTime.ps1
|
function Get-DokuServerTime { <# .SYNOPSIS Returns the current time from the remote wiki server as Unix timestamp .DESCRIPTION Returns the current time from the remote wiki server as Unix timestamp .PARAMETER Raw Output the raw response from the server in UNIX time rather than a DateTime .EXAMPLE PS C:\> $serverTime = Get-DokuServerTime .EXAMPLE PS C:\> $UnixserverTime = Get-DokuServerTime -Raw .OUTPUTS System.DateTime, System.Int32 .NOTES AndyDLP - 2018-05-26 #> [CmdletBinding()] [OutputType([datetime], [int])] param ( ) begin { } # begin process { $APIResponse = Invoke-DokuApiCall -MethodName 'dokuwiki.getTime' -MethodParameters @() if ($APIResponse.CompletedSuccessfully -eq $true) { [bigint]$RawDokuTime = ($APIResponse.XMLPayloadResponse | Select-Xml -XPath "//value/int").Node.InnerText $DateObject = New-Object PSObject -Property @{ Server = $Script:DokuServer.Server UNIXTimestamp = $RawDokuTime ServerTime = ([datetime]'1970-01-01 00:00:00').AddSeconds($RawDokuTime) } $DateObject } elseif ($null -eq $APIResponse.ExceptionMessage) { Write-Error "Fault code: $($APIResponse.FaultCode) - Fault string: $($APIResponse.FaultString)" } else { Write-Error "Exception: $($APIResponse.ExceptionMessage)" } } # process end { } # end } |