

Get-RyverForum¶

SYNOPSIS¶

Query for Ryver public forum channels.

SYNTAX¶

ID (Default)¶

Get-RyverForum [[-ID] <UInt64>] [-Detailed] [-Raw] [[-Credential] <PSCredential>] [-IncludeTotalCount]
 [-Skip <UInt64>] [-First <UInt64>] [<CommonParameters>]

Name¶

Get-RyverForum [[-Name] <String>] [-Detailed] [-Raw] [[-Credential] <PSCredential>] [-IncludeTotalCount]
 [-Skip <UInt64>] [-First <UInt64>] [<CommonParameters>]

DESCRIPTION¶

Query for Ryver public forum channels.

EXAMPLES¶

EXAMPLE 1¶

Get-RyverForum -ID 12345678

Queries for the public forum channel with ID 12345678.

EXAMPLE 2¶

12345678 | Get-RyverForum

Queries for the public forum channel with ID 12345678 via pipeline value.

EXAMPLE 3¶

Get-RyverForum 12345678

Queries for the public forum channel with ID 12345678 via positional parameter.

EXAMPLE 4¶

Get-RyverForum -Name 'All Hands'

Queries for the 'All Hands' public forum channel.

EXAMPLE 5¶

Get-RyverForum -Name 'All Hand*' -Credential ( Get-Credential )

Updates the $Script:PSRyver.Authorization value storing the basic authentication authorization header to use for all requests and then queries for all public forum channels starting with the string 'All Hand', such as 'All Hands' and 'All handsome guys like that Troy fellow'. =D

EXAMPLE 6¶

'All Hands' | Get-RyverForum -Detailed

Queries for detailed information about the 'All Hands' public forum channel via the pipeline.

EXAMPLE 7¶

'*and*' | Get-RyverForum -Raw

Queries for all public forum channels containing the string 'and', such as 'All Hands' and 'The Land of Magical Unicorns' and returns the raw, unformatted output.

EXAMPLE 8¶

Get-RyverForum 'All Hands' $true $true

Queries for detailed information about the 'All Hands' public forum channel via positional parameters and returns the raw, unformatted output.

EXAMPLE 9¶

[PSCustomObject] @{ ID = [UInt64] 12345678 } | Get-RyverForum

Queries for the public forum channel with ID 12345678 via pipeline parameter name.

EXAMPLE 10¶

[PSCustomObject] @{ Name = 'All Hands' } | Get-RyverForum

Queries for the 'All Hands' public forum channel via pipeline parameter name.

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

-Detailed¶

Specifies whether to retrieve additional details about each object.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ID¶

Specifies the public forum channel ID.

Type: UInt64
Parameter Sets: ID
Aliases:

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

-Name¶

Specifies the public forum channel name. Case insensitive.

Type: String
Parameter Sets: Name
Aliases:

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

-Raw¶

Specifies that objects should not be formatted.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: 3
Default value: False
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.String¶

OUTPUTS¶

System.Management.Automation.PSObject[]¶

System.Management.Automation.PSObject¶

NOTES¶

Troy Lindsay
Twitter: @troylindsay42
GitHub: tlindsay42

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

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