Public/Set-PlexItemWatchStatus.ps1

function Set-PlexItemWatchStatus
{
    <#
        .SYNOPSIS
            Set the watch status for a Plex item.
        .DESCRIPTION
            Set the watch status for a Plex item.
        .PARAMETER Id
            Id of the item to set the watch status for.
        .PARAMETER Status
            Status to set the item to. Valid values are 'played' and 'unplayed'.
        .PARAMETER AlternativeToken
            Token for another user.
        .EXAMPLE
            Set-PlexItemWatchStatus -Id 1234 -Status played
    #>


    [CmdletBinding(SupportsShouldProcess)]
    param(
        [Parameter(Mandatory = $true)]
        [String]
        $Id,

        [Parameter(Mandatory = $true)]
        [ValidateSet('played', 'unplayed')]
        [String]
        $Status,

        [Parameter(Mandatory = $false)]
        [ValidateNotNullOrEmpty()]
        [String]
        $AlternativeToken
    )

    #############################################################################
    #Region Import Plex Configuration
    if(!$script:PlexConfigData)
    {
        try
        {
            Import-PlexConfiguration -WhatIf:$False
        }
        catch
        {
            throw $_
        }
    }
    #EndRegion

    #############################################################################
    #Region Construct Uri
    if($Status -eq 'played')
    {
        $RestEndpoint = ":/scrobble"
    }
    else
    {
        $RestEndpoint = ":/unscrobble"
    }

    $Params = [Ordered]@{
        identifier = 'com.plexapp.plugins.library'
        key        = $Id
    }

    if($AlternativeToken)
    {
        $Params.Add('X-Plex-Token', $AlternativeToken)
    }

    $DataUri = Get-PlexAPIUri -RestEndpoint $RestEndpoint -Params $Params
    #EndRegion

    #############################################################################
    #Region Make Request
    if($PSCmdlet.ShouldProcess("Set watch status for item Id $Id to $Status"))
    {
        Write-Verbose -Message "Function: $($MyInvocation.MyCommand): Setting watch status for item Id $Id to $Status"
        try
        {
            Invoke-RestMethod -Uri $DataUri -Method "GET" | Out-Null
        }
        catch
        {
            throw $_
        }
    }
    #EndRegion
}