BigFix

1.1

Public/Set-WebReportsServer.ps1

function Set-WebReportsServer {
  <#
   .Synopsis
    Sets the default Web Reports Server object.
 
   .Description
    Sets the default Web Reports Server object to use when calling New-WebReportsSession
    with the -Default switch. If the Web Reports Server object does not yet exist in
    the registry, then it will also be added.
 
   .Parameter Server
    Specifies the Web Reports Server object (created using New-WebReportsServer
    or returned from Get-WebReportsServer) to set as default.
 
   .Parameter Uri
    Specifies a well-formed absolute URI to the Web Reports Server to be set as the
    default. A new Web Reports Server object will be registered if one is not
    already found matching the URI.
 
   .Example
    # Sets the default Web Reports Session object to the Web Reports Server defined in
    # the $MyServer variable.
    Set-WebReportsServer -Server $MyServer
 
   .Example
    # Sets the default Web Reports Server object to the server 'webreports' over HTTPS,
    # creating and registering a new object if a matching one does not already exist.
    Set-WebReportsServer -Uri 'https://webreports/'
 
  #>
  [CmdletBinding(DefaultParameterSetName = 'URI')]
  Param(
    [Parameter(
      Mandatory = $true,
      Position = 0,
      ParameterSetName = 'SERVER',
      HelpMessage = 'Web Reports Server object for the Web Reports Server'
    )]
    [ValidateNotNull()]
    [PSTypeName('BigFix.WebReports.Server')]$Server,

    [Parameter(
      Mandatory = $true,
      Position = 0,
      ValueFromPipeline = $true,
      ParameterSetName = 'URI',
      HelpMessage = 'Well-formed absolute URI to the Web Reports Server (e.g. https://webreports/)'
    )]
    [ValidateScript( { Test-Uri -Uri $_ -Kind Absolute -Throw })]
    [string]$Uri
  )

  Process {
    if ($PSCmdlet.ParameterSetName -eq 'URI') {
      $Server = New-WebReportsServer -Uri $Uri -NoPersist
    }

    $Servers = Get-Variable -Name WebReportsServers -ValueOnly -Scope Script -ErrorAction SilentlyContinue

    $found = $false
    foreach ($s in @($Servers)) {
      if ($s.Uri -eq $Server.Uri) {
        $found = $true
        $Server = $s
        break
      }
    }

    if ($found -eq $false) {
      $null = Set-Variable -Name WebReportsServers -Value @($Servers + $Server) -Scope Script -Force
    }

    $null = Set-Variable -Name WebReportsServersDefault -Value $Server -Scope Script -Force

    return $Server
  }
}