Public/Set-RadarrConfiguration.ps1

function Set-RadarrConfiguration
{
    <#
        .SYNOPSIS
            Sets the configuration for connecting to a Radarr server instance.

        .DESCRIPTION
            Saves Radarr server connection settings including server address, port, API key, and API version to a JSON configuration file.
            The configuration is stored in the user's home directory under .PSRadarr/PSRadarrConfig.json.

        .PARAMETER Server
            The URL or hostname of the Radarr server (e.g. 'myserver.domain.com')

        .PARAMETER Port
            The port number that Radarr is listening on. Defaults to 7878.

        .PARAMETER Protocol
            The protocol to use for connecting to the Radarr server. Defaults to 'http'.

        .PARAMETER APIKey
            The API key from your Radarr instance. Can be found in Radarr under Settings > General.

        .PARAMETER APIVersion
            The version of the Radarr API to use. Defaults to 3.

        .PARAMETER RootFolderPath
            The root folder path where movies are stored.

        .PARAMETER Default
            If set to true, marks this server configuration as the default instance for PSRadarr commands. Defaults to true.

        .EXAMPLE
            Set-RadarrConfiguration -Server 'myserver.domain.com' -APIKey 'myapikey' -RootFolderPath 'D:\Movies'

        .NOTES
            File: Set-RadarrConfiguration.ps1
            The configuration file will be created at $HOME/.PSRadarr/PSRadarrConfig.json
    #>


    param (
        [Parameter(Mandatory = $true)]
        [string]$Server,

        [Parameter(Mandatory = $false)]
        [int]$Port = 7878,

        [Parameter(Mandatory = $false)]
        [string]$Protocol = "http",

        [Parameter(Mandatory = $true)]
        [string]$APIKey,

        [Parameter(Mandatory = $false)]
        [Int]$APIVersion = "3",

        [Parameter(Mandatory = $true)]
        [string]$RootFolderPath,

        [Parameter(Mandatory = $false)]
        [bool]$Default = $true
    )

    #############################################################################
    #Region Ensure required paths exist and load existing configuration
    $ConfigDir = Join-Path $HOME ".PSRadarr"
    if(-not (Test-Path -Path $ConfigDir -PathType Container))
    {
        try
        {
            New-Item -Path $ConfigDir -ItemType Directory -ErrorAction Stop | Out-Null
        }
        catch
        {
            throw $_
        }
    }

    # Path to the configuration file
    $ConfigPath = Join-Path $ConfigDir "PSRadarrConfig.json"

    # If the file exists, load existing data
    if(Test-Path -Path $ConfigPath -PathType Leaf)
    {
        [Array]$ConfigData = Get-Content -Path $ConfigPath | ConvertFrom-Json
    }
    else
    {
        $ConfigData = @()
    }
    #EndRegion


    #############################################################################
    # If the user has passed default as $False, but there is no existing default server (excluding itself) with
    # default set to $true, then we'll force this server to be the default.
    if($Default -eq $false -and ($ConfigData | Where-Object { $_.Default -eq $true -and $_.Server -ne $Server }).Count -eq 0)
    {
        Write-Warning -Message "No default server found. Forcing this server to be the default."
        $Default = $true
    }

    ####################################################################################################
    # If this server is being set as default, clear the default flag from all other servers:
    if($Default -eq $true)
    {
        $ConfigData | ForEach-Object { $_.Default = $false }
    }

    $Found = $false
    foreach($Entry in $ConfigData)
    {
        # If the server and port already exist in the configuration, update the rest of the data
        # that could have changed:
        if($Entry.Server -eq $Server -and $Entry.Port -eq $Port)
        {
            $Entry.Protocol = $Protocol
            $Entry.APIKey = $APIKey
            $Entry.APIVersion = $APIVersion
            $Entry.RootFolderPath = $RootFolderPath
            $Entry.Default = $Default
            $Found = $true
        }
    }

    # If we didn't find the server in the configuration, this would be a new entry:
    if($Found -eq $false)
    {
        #Construct an object with the data we want to save
        $ServerObject = [Ordered]@{
            "Server"         = $Server
            "Port"           = $Port
            "Protocol"       = $Protocol
            "APIKey"         = $APIKey
            "APIVersion"     = $APIVersion
            "RootFolderPath" = $RootFolderPath
            "Default"        = $Default
        }
        $ConfigData += $ServerObject
    }

    ####################################################################################################
    #Region Convert to JSON and save to file
    Write-Verbose -Message "Saving configuration to: $ConfigPath"
    try
    {
        # We want to make sure that $ConfigData is always an array before we export it, to ensure we can add
        # additional servers. Don't pipe $ConfigData directly to ConvertTo-Json, otherwise the first time around
        # it'll create an object instead of an array.
        ConvertTo-Json -InputObject $ConfigData -ErrorAction Stop | Set-Content -Path $ConfigPath -Force -ErrorAction Stop
    }
    catch
    {
        throw $_
    }
    Write-Verbose -Message "Configuration saved successfully to: $ConfigPath"
}