public/Initialize-AxisDevice.ps1

<#
.SYNOPSIS
Sets the root password for factory default cameras.
 
.DESCRIPTION
The Initialize-AxisDevice function is used to set the root password for Axis cameras that are in factory default state.
This command will fail on cameras that have already been initialized.
 
.PARAMETER Device
Specifies the IP address or hostname of the Axis camera.
 
.PARAMETER NewPassword
Specifies the new password to be set for the root user. If not provided, a random password will be generated.
 
.EXAMPLE
Initialize-AxisDevice -Device "192.168.1.100" -NewPassword "MyNewPassword"
 
#>

function Initialize-AxisDevice {
    [cmdletbinding()]
    Param(
        [Parameter(Mandatory=$true)]
        [String]$Device,

        [Parameter(Mandatory=$true)]
        [String]$NewPassword
    )

    $Param = @{
        Device = $Device
        Path = "/axis-cgi/pwdgrp.cgi?action=add&user=root&pwd=$($NewPassword)&grp=root&sgrp=admin:operator:viewer:ptz"
        NoAuth = $true
    }
    Try {
        $null = Invoke-AxisWebApi @Param
    }
    Catch {
        #TODO: Add better error handling
        Throw $_
    }
}