MatterMostV4

1.0.1

Public/Channels/Get-MMChannel.ps1

# Получение канала MatterMost

function Get-MMChannel {
    <#
    .SYNOPSIS
        Returns a MatterMost channel by ID, name within a team, team channel list, all channels, or filtered by expression.
    .EXAMPLE
        Get-MMChannel -All
    .EXAMPLE
        Get-MMChannel -ChannelId 'abc123'
    .EXAMPLE
        Get-MMChannel -TeamId 'team123' -Name 'general'
    .EXAMPLE
        Get-MMChannel -TeamId 'team123'
    .EXAMPLE
        Get-MMChannel -Filter { $_.name -like 'dev*' }
    .EXAMPLE
        Get-MMChannel -TeamId 'team123' -Filter { $_.type -eq 'O' }
    #>
    [OutputType('MMChannel')]
    [CmdletBinding(DefaultParameterSetName = 'ByTeam')]
    param(
        [Parameter(ParameterSetName = 'All')]
        [switch]$All,

        [Parameter(Mandatory, ParameterSetName = 'ById', ValueFromPipelineByPropertyName)]
        [Alias('id')]
        [string]$ChannelId,

        [Parameter(ParameterSetName = 'ByName')]
        [Parameter(ParameterSetName = 'ByTeam')]
        [Parameter(ParameterSetName = 'Filter')]
        [string]$TeamId,

        [Parameter(Mandatory, ParameterSetName = 'ByName', Position = 0)]
        [string]$Name,

        [Parameter(Mandatory, ParameterSetName = 'Filter')]
        [scriptblock]$Filter
    )

    process {
        switch ($PSCmdlet.ParameterSetName) {
            'All' {
                $page    = 0
                $perPage = 200
                do {
                    $batch = Invoke-MMRequest -Endpoint "channels?page=$page&per_page=$perPage"
                    $batch | ConvertTo-MMChannel
                    $page++
                } while ($batch.Count -eq $perPage)
            }
            'ById'   { Invoke-MMRequest -Endpoint "channels/$ChannelId" | ConvertTo-MMChannel }
            'ByName' {
                $resolvedTeamId = if ($TeamId) { $TeamId } else { Get-MMDefaultTeamId }
                Invoke-MMRequest -Endpoint "teams/$resolvedTeamId/channels/name/$Name" | ConvertTo-MMChannel
            }
            'ByTeam' {
                $resolvedTeamId = if ($TeamId) { $TeamId } else { Get-MMDefaultTeamId }
                $page    = 0
                $perPage = 200
                do {
                    $batch = Invoke-MMRequest -Endpoint "teams/$resolvedTeamId/channels?page=$page&per_page=$perPage"
                    $batch | ConvertTo-MMChannel
                    $page++
                } while ($batch.Count -eq $perPage)
            }
            'Filter' {
                $resolvedTeamId = if ($TeamId) { $TeamId } else { Get-MMDefaultTeamId }
                $page    = 0
                $perPage = 200
                $fetched = @()
                do {
                    $batch   = Invoke-MMRequest -Endpoint "teams/$resolvedTeamId/channels?page=$page&per_page=$perPage"
                    $fetched += $batch
                    $page++
                } while ($batch.Count -eq $perPage)
                $fetched | ConvertTo-MMChannel | Where-Object $Filter
            }
        }
    }
}