veeam-powershell-sdk.psm1

$ErrorActionPreference = 'Stop'
function New-VBRConnection {
    <#
    .SYNOPSIS
        Uses New-VBRConnection to store the connection in a global parameter
    .DESCRIPTION
        Creates a Veeam Server connection and stores it in global variable $Global:DefaultVeeamBR. 
        An FQDN or IP, credentials, and ignore certificate boolean
    .OUTPUTS
        Returns the Veeam Server connection.
    .EXAMPLE
    New-VBRConnection -Endpoint <FQDN or IP> -Port <default 9419> -Credential $(Get-Credential)  

    #>

    [CmdletBinding()]
    Param(
  
        [Parameter(Position=0,mandatory=$true)]
        [string]$Endpoint,

        [Parameter(Position=1,mandatory=$true)]
        [string]$Port, 

        [Parameter(Mandatory=$true,ParameterSetName="Credential")]
        [ValidateNotNullOrEmpty()]
        [Management.Automation.PSCredential]$Credential

    )
    
    $apiUrl = "https://$($Endpoint):$($Port)/api/oauth2/token"

    $User = $Credential.UserName
    $Pass = $Credential.GetNetworkCredential().Password

    # Define the headers for the API request
    $headers = @{
        "Content-Type"  = "application/x-www-form-urlencoded"
        "x-api-version" = "1.1-rev0"
    }

    ## TO-DO: Grant_type options
    $body = @{
        "grant_type" = "password"
        "username"   = $User
        "password"   = $Pass
    }

    # Send an authentication request to obtain a session token
    try {
        $response = Invoke-RestMethod -Uri $apiUrl -Headers $headers -Method Post -Body $body -SkipCertificateCheck 
        
        if (($response.access_token) -or ($response.StatusCode -eq 200) ) {
            Write-Host "Successfully authenticated."
            $VBRAuthentication = [PSCustomObject]@{
                Session_endpoint       = $Endpoint
                Session_port           = $Port
                Session_access_token  = $response.access_token
            }
        
            return $VBRAuthentication
        }
        else {
            Write-Host "Authentication failed. Status code: $($response.StatusCode), Message: $($response.Content)"
        }
    }
    catch {
        Write-Host "An error occurred: $($_.Exception.Message)"
    }
}

function Get-Jobs {
    <#
    .SYNOPSIS
        Uses Get-BackupJobs to retrive the backup jobs coordinated by the backup server/ 
    .DESCRIPTION
        This allows you to get an array of all jobs coordinated by the backup server.
    .OUTPUTS
        Returns the all jobs.
    .EXAMPLE
        

    #>
    
    [CmdletBinding()]
    Param(
        [Parameter(Position=0,mandatory=$true)]
        [PSCustomObject]$VBRConnection,

        [Parameter(Position=1,mandatory=$false)]
        [String]$JobID
    )

     
    if ($JobID -eq $null){
        $apiUrl = "https://$($VBRConnection.Session_endpoint):$($VBRConnection.Session_post)/v1/jobs"
    } else {
        $apiUrl = "https://$($VBRConnection.Session_endpoint):$($VBRConnection.Session_post)/v1/jobs/" + $JobID
    }

    # Define the headers for the API request
    $headers = @{
        "x-api-version" = "1.1-rev0"
        "Authorization" = "Bearer $($VBRConnection.Session_access_token)"
    }

    # Send a request to get a list of backup jobs
    try {
        $response = Invoke-RestMethod -Uri $apiUrl -Headers $headers -Method GET -SkipCertificateCheck
        
        # Process the response data as needed
        return $response.data
    }
    catch {
        Write-Host "An error occurred: $($_.Exception.Message)"
        return $null
    }
}


function Get-Backups {
    <#
    .SYNOPSIS
        Uses Get-Backups to retrive the backup  by the backup server.
    .DESCRIPTION
        This allows you to get a list of all the backups coordinated by the backup server.
    .OUTPUTS
        Returns the all backups.
    .EXAMPLE
        

    #>
    
    [CmdletBinding()]
    Param(
        [Parameter(Position=0,mandatory=$true)]
        [PSCustomObject]$VBRConnection,

        [Parameter(Position=1,mandatory=$false)]
        [String]$BackupID
    )

     
    if ($BackupID -eq $null){
        $apiUrl = "https://$($VBRConnection.Session_endpoint):$($VBRConnection.Session_post)/v1/backups"
    } else {
        $apiUrl = "https://$($VBRConnection.Session_endpoint):$($VBRConnection.Session_post)/v1/backups/" + $BackupID
    }

    # Define the headers for the API request
    $headers = @{
        "x-api-version" = "1.1-rev0"
        "Authorization" = "Bearer $($VBRConnection.Session_access_token)"
    }

    # Send a request to get a list of backup jobs
    try {
        $response = Invoke-RestMethod -Uri $apiUrl -Headers $headers -Method GET -SkipCertificateCheck
        
        # Process the response data as needed
        return $response.data
    }
    catch {
        Write-Host "An error occurred: $($_.Exception.Message)"
        return $null
    }
}

function Get-Repositories {
    <#
    .SYNOPSIS
        Uses Get-Repositories to retrive the backup by the backup server.
    .DESCRIPTION
        This allows you to get a list of all the backups coordinated by the backup server.
    .OUTPUTS
        Returns the all backups.
    .EXAMPLE
        

    #>
    
    [CmdletBinding()]
    Param(
        [Parameter(Position=0,mandatory=$true)]
        [PSCustomObject]$VBRConnection,

        [Parameter(Position=1,mandatory=$false)]
        [String]$RepositoryID
    )

     
    if ($RepositoryID -eq $null){
        $apiUrl = "https://$($VBRConnection.Session_endpoint):$($VBRConnection.Session_post)/api/v1/backupInfrastructure/repositories"
    } else {
        $apiUrl = "https://$($VBRConnection.Session_endpoint):$($VBRConnection.Session_post)/api/v1/backupInfrastructure/repositories/" + $RepositoryID
    }

    # Define the headers for the API request
    $headers = @{
        "x-api-version" = "1.1-rev0"
        "Authorization" = "Bearer $($VBRConnection.Session_access_token)"
    }

    # Send a request to get a list of backup jobs
    try {
        $response = Invoke-RestMethod -Uri $apiUrl -Headers $headers -Method GET -SkipCertificateCheck
        
        # Process the response data as needed
        return $response.data
    }
    catch {
        Write-Host "An error occurred: $($_.Exception.Message)"
        return $null
    }
}


function Add-RepositoryAzureBlob {
    [CmdletBinding()]
    Param(
        [Parameter(Position=0,mandatory=$true)]
        [PSCustomObject]$VBRConnection,

        [Parameter(Position=1,mandatory=$true)]
        [String]$Name,

        [Parameter(Position=2,mandatory=$true)]
        [String]$Desciption,

        [Parameter(Position=1,mandatory=$true)]
        [PSCustomObject]$AzureAccount
    )
    
    $apiUrl = "https://$($VBRConnection.Session_endpoint):$($VBRConnection.Session_post)/api/v1/backupInfrastructure/repositories"

    # Define the headers for the API request
    $headers = @{
        "x-api-version" = "1.1-rev0"
        "Authorization" = "Bearer $($VBRConnection.Session_access_token)"
    }

     # Define the body for the API request
    $body = @{
        "kind"      = "AzureBlob"
    } 
    
    # Send a request to get a list of backup jobs
    try {
        $response = Invoke-RestMethod -Uri $apiUrl -Headers $headers -Body $body -Method POST -SkipCertificateCheck
        
        # Process the response data as needed
        return $response.data
    }
    catch {
        Write-Host "An error occurred: $($_.Exception.Message)"
        return $null
    }


}