functions/Get-PSBlueSkyFollower.ps1
|
Function Get-BskyFollowers { [CmdletBinding(DefaultParameterSetName = "Limit")] [OutputType('PSBlueskyFollowProfile')] Param( [Parameter( Position = 0, HelpMessage = "Enter the number of followers to retrieve between 1 and 100. Default is 50.", ParameterSetName = "Limit" )] [ValidateRange(1,100)] [int]$Limit = 50, [Parameter(ParameterSetName = "All",HelpMessage = "Return All followers")] [switch]$All, [Parameter(Mandatory, HelpMessage = 'A PSCredential with your Bluesky username and password')] [PSCredential]$Credential ) Begin { Write-Verbose "[$((Get-Date).TimeOfDay) BEGIN ] Starting $($MyInvocation.MyCommand)" if ($MyInvocation.CommandOrigin -eq 'Runspace') { #Hide this metadata when the command is called from another command Write-Verbose "[$((Get-Date).TimeOfDay) BEGIN ] Running module version $ModuleVersion" Write-Verbose "[$((Get-Date).TimeOfDay) BEGIN ] Using PowerShell version $($PSVersionTable.PSVersion)" Write-Verbose "[$((Get-Date).TimeOfDay) BEGIN ] Running on $($PSVersionTable.OS)" } $token = Get-BskyAccessToken -Credential $Credential $UserName = $Credential.UserName $did = $script:BskySession.did } #begin Process { If ($token) { Write-Verbose "[$((Get-Date).TimeOfDay) PROCESS] Querying $limit followers for $Username" if ($PSCmdlet.ParameterSetName -eq 'Limit') { $apiUrl = "$PDSHOST/xrpc/app.bsky.graph.getFollowers?limit=$Limit&actor=$did" } else { $apiUrl = "$PDSHOST/xrpc/app.bsky.graph.getFollowers?limit=100&actor=$did" } Write-Verbose "[$((Get-Date).TimeOfDay) PROCESS] Processing: $apiUrl" $headers = @{ Authorization = "Bearer $token" 'Content-Type' = 'application/json' } $results = @() $response = Invoke-RestMethod -Uri $apiUrl -Method Get -Headers $headers -ResponseHeadersVariable rh Write-Information -MessageData $rh -tags ResponseHeader If ($response) { $results += $response.followers Write-Information -MessageData $response -Tags raw if ($PSCmdlet.ParameterSetName -eq 'All') { Write-Verbose "[$((Get-Date).TimeOfDay) PROCESS] Getting all followers from $($response.cursor)" # iterate remaining pages using 'cursor' response value while ($response.cursor) { $url = $apiUrl+"&cursor=$($response.cursor)" $response = Invoke-RestMethod -Uri $url -Method Get -Headers $headers If ($response.followers) { Write-Information -MessageData $response -Tags raw $results += $response.followers } } } #If All foreach ($profile in $results) { [PSCustomObject]@{ PSTypeName = 'PSBlueskyFollowProfile' Username = $profile.handle Display = ($profile.displayName) ? $profile.displayName : $profile.handle Created = $profile.createdAt.ToLocalTime() Description = $profile.description URL = "https://bsky.app/profile/$($profile.handle)" } } } #if response else { Write-Warning 'Failed to retrieve followers.' } } else { Write-Warning 'Failed to authenticate.' } } #process End { Write-Verbose "[$((Get-Date).TimeOfDay) END ] Ending $($MyInvocation.MyCommand)" } #end } |