Skip to content

Get-RyverHistory

SYNOPSIS

Get history from a Ryver public forum or private team channel.

SYNTAX

Get-RyverHistory [-ID] <UInt64> [-Type] <String> [-Raw] [[-Credential] <PSCredential>] [-IncludeTotalCount]
 [-Skip <UInt64>] [-First <UInt64>] [<CommonParameters>]

DESCRIPTION

Get history from a Ryver public forum or private team channel.

EXAMPLES

EXAMPLE 1

Get-RyverHistory -ID 12345678 -Type 'Team'

Queries for the chat history of the private team channel with ID 12345678.

EXAMPLE 2

Get-RyverHistory -ID 12345678 -Type 'Forum' -Credential ( Get-Credential )

Updates the $Script:PSRyver.Authorization value storing the basic authentication authorization header to use for all requests and then queries for the chat history of the public forum channel with ID 12345678.

EXAMPLE 3

12345678 | Get-RyverHistory -Type 'User' -Raw

Queries for the chat history with the user with ID 12345678 via pipeline value, and returns the raw, unformatted output.

EXAMPLE 4

[PSCustomObject] @{ ID = 12345678; Type = 'Team' } | Get-RyverHistory

Queries for the chat history with the user with ID 12345678 via pipeline parameter names.

EXAMPLE 5

Get-RyverHistory 12345678 'Forum' $true

Queries for the chat history of the public forum channel with ID 12345678 via positional parameter and returns the raw, unformatted output.

PARAMETERS

-Credential

Credentials to use for the Ryver API.

Default value is the value set by Set-PSRyverConfig.

Type: PSCredential
Parameter Sets: (All)
Aliases:

Required: False
Position: 4
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ID

Specifies the ID of the public forum channel, private team channel, or user direct message to download the chat history from.

Type: UInt64
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: 0
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-Raw

Specifies that objects should not be formatted.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: 3
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-Type

Specifies the type of channel to post the message in: - Public forum - Private team - User direct message

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 2
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-IncludeTotalCount

Reports the number of objects in the data set (an integer) followed by the objects. If the cmdlet cannot determine the total count, it returns 'Unknown total count'.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Skip

Ignores the first 'n' objects and then gets the remaining objects.

Type: UInt64
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-First

Gets only the first 'n' objects.

Type: UInt64
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).

INPUTS

System.UInt64

System.Management.Automation.PSCustomObject

OUTPUTS

NOTES

  • Troy Lindsay
  • Twitter: @troylindsay42
  • GitHub: tlindsay42

https://tlindsay42.github.io/PSRyver/Public/Get-RyverHistory/

https://github.com/tlindsay42/PSRyver/blob/master/PSRyver/Public/Get-RyverHistory.ps1