Public/Get-GW2PvPRanks.ps1
|
<#
.SYNOPSIS Retrieves PvP ranks from the Guild Wars 2 API. .DESCRIPTION The Get-GW2PvPRanks cmdlet retrieves information about PvP Ranks. .PARAMETER Ids The ID(s) of the ranks to retrieve. Can be a single ID, an array of IDs, or "all". .PARAMETER Lang The language to return localized text in. Defaults to "en". Valid values: "en", "es", "de", "fr", "zh". .EXAMPLE Get-GW2PvPRanks -Ids 1 Retrieves information for PvP Rank 1 (Rabbit). .EXAMPLE Get-GW2PvPRanks -Ids "all" Retrieves information for all PvP Ranks. .NOTES API Endpoint: /v2/pvp/ranks #> function Get-GW2PvPRanks { [CmdletBinding()] param ( [Parameter(Mandatory = $false)] [object]$Ids, [Parameter(Mandatory = $false)] [ValidateSet("en", "es", "de", "fr", "zh")] [string]$Lang ) $Uri = "https://api.guildwars2.com/v2/pvp/ranks" if ($Ids) { $Uri += "?ids=" + ($Ids -join ",") } if ($Lang) { $Uri += "&lang=$Lang" } try { Invoke-RestMethod -Uri $Uri -Method Get } catch { Write-Error "Failed to retrieve PvP ranks: $_" } } |