Public/Connect-MITServer.ps1
|
function Connect-MITServer { <# .SYNOPSIS Connectot a MOVEit Transfer server and create an auth token. .DESCRIPTION Create an auth token using the /api/v1/token endpoint. Call before calling any other Get-MIT* commands. .EXAMPLE Connect-MITServer User is prompted for parameters. .EXAMPLE Connect-MITServer -Hostname 'moveit.server.com' -Credential (Get-Credential -Username 'admin') Supply parameters on command line except for password. .INPUTS None. .OUTPUTS String message if connected. .LINK See link for /api/v1/token doc. https://docs.ipswitch.com/MOVEit/Transfer2020/API/rest/#operation/Auth_GetToken #> [CmdletBinding()] param ( # Hostname for the endpoint [Parameter(Mandatory=$true)] [string]$Hostname, # Credentials [Parameter(Mandatory=$true)] [pscredential]$Credential ) try { # Clear any existing Token $script:Token = @() # Set the Base Uri $script:BaseUri = "https://$Hostname/api/v1" # Build the request $uri = "$script:BaseUri/token" $params = @{ Method = 'POST' ContentType = 'application/x-www-form-urlencoded' Headers = @{Accept = "application/json"} } $response = @{ grant_type = 'password' username = $Credential.UserName password= $Credential.GetNetworkCredential().Password } | Invoke-RestMethod -Uri $uri @params -UserAgent 'MOVEit REST API' if ($response.access_token) { $script:Token = @{ AccessToken = $Response.access_token CreatedAt = $(Get-Date) ExpiresIn = $Response.expires_in RefreshToken = $Response.refresh_token } Write-Output "Connected to MOVEit Transfer server $Hostname" } } catch { $PSCmdlet.ThrowTerminatingError($PSItem) } } |