Get-RyverTeam¶
SYNOPSIS¶
Query for Ryver private team channels.
SYNTAX¶
ID (Default)¶
Get-RyverTeam [[-ID] <UInt64>] [-Detailed] [-Raw] [[-Credential] <PSCredential>] [-IncludeTotalCount] [-Skip <UInt64>] [-First <UInt64>] [<CommonParameters>]
Name¶
Get-RyverTeam [[-Name] <String>] [-Detailed] [-Raw] [[-Credential] <PSCredential>] [-IncludeTotalCount] [-Skip <UInt64>] [-First <UInt64>] [<CommonParameters>]
DESCRIPTION¶
Query for Ryver private team channels.
EXAMPLES¶
EXAMPLE 1¶
Get-RyverTeam -ID 12345678
Queries for the private team channel with ID 12345678.
EXAMPLE 2¶
12345678 | Get-RyverTeam
Queries for the private team channel with ID 12345678 via pipeline value.
EXAMPLE 3¶
Get-RyverTeam 12345678
Queries for the private team channel with ID 12345678 via positional parameter.
EXAMPLE 4¶
Get-RyverTeam -Name 'Members Only!'
Queries for the 'Members Only!' private team channel.
EXAMPLE 5¶
Get-RyverTeam -Name '*Only*' -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 private team channels containing the string 'Only', such as 'Members Only!' and 'Ninjas only'.
EXAMPLE 6¶
'Members Only!' | Get-RyverTeam -Raw
Queries for the 'Members Only!' private team channel via the pipeline and returns the raw, unformatted output.
EXAMPLE 7¶
'*Member*' | Get-RyverTeam -Detailed
Queries for detailed information about all private team channels containing the string 'Member', such as 'Members Only!' and 'Illuminati Membership Committee'.
EXAMPLE 8¶
Get-RyverTeam 'Members Only!' $true $true
Queries for detailed information about the 'Members Only!' private team channel via positional parameters and returns the raw, unformatted output.
EXAMPLE 9¶
[PSCustomObject] @{ ID = [UInt64] 12345678 } | Get-RyverTeam
Queries for the private team channel with ID 12345678 via pipeline parameter name.
EXAMPLE 10¶
[PSCustomObject] @{ Name = 'Members Only!' } | Get-RyverTeam
Queries for the 'Members Only!' private team 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¶
Private team 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
RELATED LINKS¶
https://tlindsay42.github.io/PSRyver/Public/Get-RyverTeam/
https://github.com/tlindsay42/PSRyver/blob/master/PSRyver/Public/Get-RyverTeam.ps1