...
...
...
...
...
...
...

ToRainDrop PowerShell - ToRainDropPS Module

ToRainDropPS Module

You can interact with the ToRainDrop API from any language or plaftorm. However, to help accelerate adoption we provide a simple PowerShell library (ToRainDropPS) to interact with the ToRainDrop API using familiar PowerShell verbs and nouns.

Getting Started

Register ToRainDropPS Module Repository

$ToRainDropPSModuleRepository = @{
    Name = "ToRainDropPSRepository"
    SourceLocation = "https://modules.beta-powershell.toraindrop.cloud/api"
};

Register-PSRepository @ToRainDropPSModuleRepository;
Get-PSRepository;

Check ToRainDropPS Module in Repository (Optional)

Find-Package -Source "ToRainDropPSRepository" -Name "ToRainDropPS";

Install or Save ToRainDropPS Module

Install-Module -Name "ToRainDropPS" -Repository "ToRainDropPSRepository";
                
## OR ##

Save-Module -Name "ToRainDropPS" -Repository "ToRainDropPSRepository" -Path "C:\<Your-PowerShell-Modules-Path>\";
Import-Module "C:\<Your-PowerShell-Modules-Path>\ToRainDropPS";

Unregister ToRainDropPS Module Repository

Unregister-PSRepository -Name "ToRainDropPSRepository";
Get-PSRepository;

ToRainDropPS Reference

Connect-ToRainDrop

SYNOPSIS

Sets the ToRainDrop ClientID and APIToken.

SYNTAX

Connect-ToRainDrop [[-ClientID] <String>] [[-Token] <String>] [<CommonParameters>]

DESCRIPTION

Sets both the ClientID and APIToken for the current ToRainDrop Session.

Prompts ‘Please Enter Client ID’ if no ClientID found for the current ToRainDrop Session.
Prompts ‘Please Enter API Token’ if no APIToken found for the current ToRainDrop Session.

EXAMPLES

EXAMPLE 1

Connect-ToRainDrop;

EXAMPLE 2

Connect-ToRainDrop -ClientID $myToRainDropClientIDString -Token $myToRainDropAPITokenString;

PARAMETERS

-ClientID

(Optional) Specifies the ClientID Value.

Type: String
Parameter Sets: (All)
Aliases:

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

-Token

(Optional) Specifies the APIToken Value.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 2
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.

INPUTS

None.

OUTPUTS

None.

NOTES

None.

Connect-ToRainDrop
Disconnect-ToRainDrop

Disconnect-ToRainDrop

SYNOPSIS

Clears the ToRainDrop ClientID and APIToken.

SYNTAX

Disconnect-ToRainDrop

DESCRIPTION

Clears / Removes both the ClientID and APIToken for the current ToRainDrop Session.

EXAMPLES

EXAMPLE 1

Disconnect-ToRainDrop;

PARAMETERS

None.

INPUTS

None.

OUTPUTS

None.

NOTES

None.

Connect-ToRainDrop
Disconnect-ToRainDrop

Get-ToRainDropClientID

SYNOPSIS

Gets the ToRainDrop ClientID.

SYNTAX

Get-ToRainDropClientID

DESCRIPTION

Gets the ClientID for the current ToRainDrop Session.

Prompts ‘Please Enter Client ID’ if no ClientID found for the current ToRainDrop Session.

EXAMPLES

EXAMPLE 1

Get-ToRainDropClientID;

PARAMETERS

None.

INPUTS

None.

OUTPUTS

[String]ToRainDropClientID.

NOTES

None.

Get-ToRainDropClientID
Set-ToRainDropClientID
Clear-ToRainDropClientID

Set-ToRainDropClientID

SYNOPSIS

Sets the ToRainDrop ClientID.

SYNTAX

Set-ToRainDropClientID [-ClientID] <SecureString> [<CommonParameters>]

DESCRIPTION

Sets the ClientID for the current ToRainDrop Session.

EXAMPLES

EXAMPLE 1

Set-ToRainDropClientID -ClientID (Read-Host "Please Enter Client ID" -AsSecureString);

EXAMPLE 2

(Read-Host "Please Enter Client ID" -AsSecureString) | Set-ToRainDropClientID;

PARAMETERS

-ClientID

Specifies the ClientID Value.

Type: SecureString
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByValue)
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.

INPUTS

[SecureString]$ClientID

You can pipe [SecureString]$ClientID objects to Set-ToRainDropClientID.

OUTPUTS

None.

NOTES

None.

Get-ToRainDropClientID
Set-ToRainDropClientID
Clear-ToRainDropClientID

Clear-ToRainDropClientID

SYNOPSIS

Clears the ToRainDrop ClientID.

SYNTAX

Clear-ToRainDropClientID

DESCRIPTION

Clears / Removes the ClientID for the current ToRainDrop Session.

EXAMPLES

EXAMPLE 1

Clear-ToRainDropClientID;

PARAMETERS

None.

INPUTS

None.

OUTPUTS

None.

NOTES

None.

Get-ToRainDropClientID
Set-ToRainDropClientID
Clear-ToRainDropClientID

Get-ToRainDropAPIToken

SYNOPSIS

Gets the ToRainDrop APIToken.

SYNTAX

Get-ToRainDropAPIToken

DESCRIPTION

Gets the APIToken for the current ToRainDrop Session.

Prompts ‘Please Enter API Token’ if no APIToken found for the current ToRainDrop Session.

EXAMPLES

EXAMPLE 1

Get-ToRainDropAPIToken;

PARAMETERS

None.

INPUTS

None.

OUTPUTS

[String]ToRainDropAPIToken.

NOTES

None.

Get-ToRainDropAPIToken
Set-ToRainDropAPIToken
Clear-ToRainDropAPIToken

Set-ToRainDropAPIToken

SYNOPSIS

Sets the ToRainDrop APIToken.

SYNTAX

Set-ToRainDropAPIToken [-Token] <SecureString> [<CommonParameters>]

DESCRIPTION

Sets the APIToken for the current ToRainDrop Session.

EXAMPLES

EXAMPLE 1

Set-ToRainDropAPIToken -Token (Read-Host "Please Enter API Token" -AsSecureString);

EXAMPLE 2

(Read-Host "Please Enter API Token" -AsSecureString) | Set-ToRainDropAPIToken;

PARAMETERS

-Token

Specifies the APIToken Value.

Type: SecureString
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByValue)
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.

INPUTS

[SecureString]$Token

You can pipe [SecureString]$Token objects to Set-ToRainDropAPIToken.

OUTPUTS

None.

NOTES

None.

Get-ToRainDropAPIToken
Set-ToRainDropAPIToken
Clear-ToRainDropAPIToken

Clear-ToRainDropAPIToken

SYNOPSIS

Clears the ToRainDrop APIToken.

SYNTAX

Clear-ToRainDropAPIToken

DESCRIPTION

Clears / Removes the APIToken for the current ToRainDrop Session.

EXAMPLES

EXAMPLE 1

Clear-ToRainDropAPIToken;

PARAMETERS

None.

INPUTS

None.

OUTPUTS

None.

NOTES

None.

Get-ToRainDropAPIToken
Set-ToRainDropAPIToken
Clear-ToRainDropAPIToken

New-ToRainDropHeaders

SYNOPSIS

Create a new ToRainDropHeaders.

SYNTAX

New-ToRainDropHeaders [[-Token] <String>] [<CommonParameters>]

DESCRIPTION

Creates a new ToRainDropHeaders Dictionary.

(Optional) Token Parameter Specifies an APIToken String to be used instead of APIToken from current ToRainDrop Session.

EXAMPLES

EXAMPLE 1

$myNewToRainDropHeaders = New-ToRainDropHeaders;

EXAMPLE 2

$myNewToRainDropHeaders = New-ToRainDropHeaders -Token $myToRainDropAPITokenString;

EXAMPLE 3

$myNewToRainDropHeaders = $myToRainDropAPITokenString | New-ToRainDropHeaders;

PARAMETERS

-Token

(Optional) Specifies the APIToken Value.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 1
Default value: None
Accept pipeline input: True (ByValue)
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.

INPUTS

[String]$Token

You can pipe [String]$Token objects to New-ToRainDropHeaders.

OUTPUTS

Dictionary[[String],[String]]ToRainDropHeaders.

NOTES

None.

New-ToRainDropHeaders
New-ToRainDropRequstBody
New-ToRainDropRequest

New-ToRainDropRequstBody

SYNOPSIS

Create a new ToRainDropRequstBody.

SYNTAX

New-ToRainDropRequstBody [-ClientID] <String> [-Value] <String> [[-Key] <String>] [[-Parameters] <Hashtable>]
 [[-ConnectionParameters] <Hashtable>] [<CommonParameters>]

DESCRIPTION

Create a new ToRainDropRequstBody as a JSON String.

ClientID Parameter specifies the ClientID to be used.
Value Parameter specifies the Value to be used.

(Optional) Key Parameter specifies the Key to be used.
(Optional) Parameters Parameter specifies the Parameters to be used.
(Optional) ConnectionParameters Parameter specifies the ConnectionParameters to be used.

EXAMPLES

EXAMPLE 1

$myNewToRainDropRequstBody = New-ToRainDropRequstBody -ClientID $myToRainDropClientIDString -Value $MyRequstValueString;

EXAMPLE 2

$myParameters = @{ ExampleParameterName1 = "Example-Value-ABC-123"; ExampleParameterName2 = "Example-Value-DEF-456" };

$myNewToRainDropRequstBody = New-ToRainDropRequstBody -ClientID $myToRainDropClientIDString -Value $MyRequstValueString -Parameters $myParameters;

PARAMETERS

-ClientID

Specifies the ClientID Value.

Type: String
Parameter Sets: (All)
Aliases:

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

-Value

Specifies the Value Value.

Type: String
Parameter Sets: (All)
Aliases:

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

-Key

(Optional) Specifies the Key Value.

Type: String
Parameter Sets: (All)
Aliases:

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

-Parameters

(Optional) Specifies the [hashtable] Parameters Value.

Type: Hashtable
Parameter Sets: (All)
Aliases:

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

-ConnectionParameters

(Optional) Specifies the [hashtable] ConnectionParameters Value.

Type: Hashtable
Parameter Sets: (All)
Aliases:

Required: False
Position: 5
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.

INPUTS

None.

OUTPUTS

[String]ToRainDropRequstBody.

NOTES

None.

New-ToRainDropHeaders
New-ToRainDropRequstBody
New-ToRainDropRequest

New-ToRainDropRequest

SYNOPSIS

Create a new ToRainDropRequest.

SYNTAX

New-ToRainDropRequest [-ToRainDropRequstURI] <String> [-ToRainDropRequstBody] <String> [<CommonParameters>]

DESCRIPTION

Creates and Invokes a new ToRainDropRequest.

ToRainDropRequstURI Parameter Specifies the URI used by the invoke of the ToRainDropRequest.
ToRainDropRequstBody Parameter Specifies the Body used by the invoke of the ToRainDropRequest.

EXAMPLES

EXAMPLE 1

$myToRainDropRequestResponse = New-ToRainDropRequest -ToRainDropRequstURI $myToRainDropRequstURI -ToRainDropRequstBody $myToRainDropRequstBody;

PARAMETERS

-ToRainDropRequstURI

ToRainDropRequstURI Parameter Specifies the URI

Type: String
Parameter Sets: (All)
Aliases:

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

-ToRainDropRequstBody

ToRainDropRequstBody Parameter Specifies the Body

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 2
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.

INPUTS

None.

OUTPUTS

[PSObject]ToRainDropRequestResponse.

NOTES

None.

New-ToRainDropHeaders
New-ToRainDropRequstBody
New-ToRainDropRequest

Get-ToRainDropAPI

SYNOPSIS

Gets Details of a ToRainDropAPI.

SYNTAX

Get-ToRainDropAPI [-APIName] <String> [[-ClientID] <String>] [[-Token] <String>] [<CommonParameters>]

DESCRIPTION

Gets the Details of a ToRainDropAPI Specifed by the APIName

Prompts ‘Please Enter Client ID’ if no ClientID found for the current ToRainDrop Session.
Prompts ‘Please Enter API Token’ if no APIToken found for the current ToRainDrop Session.

EXAMPLES

EXAMPLE 1

$myToRainDropAPI = Get-ToRainDropAPI -APIName "My-ToRainDropAPI-Name";

EXAMPLE 2

$myToRainDropAPI = "My-ToRainDropAPI-Name" | Get-ToRainDropAPI;

EXAMPLE 3

$myToRainDropAPI = Get-ToRainDropAPI -APIName "My-ToRainDropAPI-Name" -ClientID $myToRainDropClientIDString -Token $myToRainDropAPITokenString;

PARAMETERS

-APIName

Specifies the APIName Value.

Type: String
Parameter Sets: (All)
Aliases:

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

-ClientID

(Optional) Specifies the ClientID Value.

Type: String
Parameter Sets: (All)
Aliases:

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

-Token

(Optional) Specifies the APIToken Value.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 3
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.

INPUTS

None.

OUTPUTS

[hashtable]ToRainDropAPI.

NOTES

None.

Get-ToRainDropAPI
New-ToRainDrop
Get-ToRainDrop

New-ToRainDrop

SYNOPSIS

Create New ToRainDrop Execution

SYNTAX

New-ToRainDrop [-APIBody] <Hashtable> [[-Parameters] <Hashtable>] [[-ConnectionParameters] <Hashtable>]
 [[-ClientID] <String>] [[-Token] <String>] [<CommonParameters>]

DESCRIPTION

Creates a New ToRainDrop Execution based on the ToRainDropAPI Specifed by the APIBody, Parameters and ConnectionParameters values.

Prompts ‘Please Enter Client ID’ if no ClientID found for the current ToRainDrop Session.
Prompts ‘Please Enter API Token’ if no APIToken found for the current ToRainDrop Session.

EXAMPLES

EXAMPLE 1

$myToRainDropAPI = Get-ToRainDropAPI -APIName 
"My-ToRainDropAPI-Name";

$myNewToRainDropExecution = New-ToRainDrop -APIBody $myToRainDropAPI.APIBody;

EXAMPLE 2

$myToRainDropAPI = Get-ToRainDropAPI -APIName "My-ToRainDropAPI-Name";

$myParameters = @{ ExampleParameterName1 = "Example-Value-ABC-123"; ExampleParameterName2 = "Example-Value-DEF-456" };

$myNewToRainDropExecution = New-ToRainDrop -APIBody $myToRainDropAPI.APIBody -Parameters $myParameters;

EXAMPLE 3

$myToRainDropAPI = "My-ToRainDropAPI-Name" | Get-ToRainDropAPI;

$myNewToRainDropExecution = $myToRainDropAPI.APIBody | New-ToRainDrop;

EXAMPLE 4

$myToRainDropAPI = "My-ToRainDropAPI-Name" | Get-ToRainDropAPI;

$myParameters = @{ ExampleParameterName1 = "Example-Value-ABC-123"; ExampleParameterName2 = "Example-Value-DEF-456" };

$myNewToRainDropExecution = $myToRainDropAPI.APIBody | New-ToRainDrop -Parameters $myParameters;

PARAMETERS

-APIBody

Specifies the [hashtable] APIBody Value.

Type: Hashtable
Parameter Sets: (All)
Aliases:

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

-Parameters

(Optional) Specifies the [hashtable] Parameters Value.

Type: Hashtable
Parameter Sets: (All)
Aliases:

Required: False
Position: 2
Default value: @{}
Accept pipeline input: False
Accept wildcard characters: False

-ConnectionParameters

(Optional) Specifies the [hashtable] ConnectionParameters Value.

Type: Hashtable
Parameter Sets: (All)
Aliases:

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

-ClientID

(Optional) Specifies the ClientID Value.

Type: String
Parameter Sets: (All)
Aliases:

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

-Token

(Optional) Specifies the APIToken Value.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 5
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.

INPUTS

[hashtable]$APIBody

You can pipe [hashtable]$APIBody objects to New-ToRainDrop.

OUTPUTS

[PSObject]ToRainDropExecution.

NOTES

None.

Get-ToRainDropAPI
New-ToRainDrop
Get-ToRainDrop

Get-ToRainDrop

SYNOPSIS

Get Result of a ToRainDrop Execution.

SYNTAX

Get-ToRainDrop [-Key] <String> [[-ClientID] <String>] [[-Token] <String>] [<CommonParameters>]

DESCRIPTION

Gets the Result Details of a ToRainDrop Execution Specifed by the Execution Key.

Prompts ‘Please Enter Client ID’ if no ClientID found for the current ToRainDrop Session.
Prompts ‘Please Enter API Token’ if no APIToken found for the current ToRainDrop Session.

EXAMPLES

EXAMPLE 1

$myToRainDropResult = Get-ToRainDrop -Key $myToRainDropExecutionKeyCmdIdString;

EXAMPLE 2

$myToRainDropResult = $myToRainDropExecutionKeyCmdIdString | Get-ToRainDrop;

EXAMPLE 3

$myToRainDropResult = Get-ToRainDrop -Key $myToRainDropExecutionKeyCmdIdString -ClientID $myToRainDropClientIDString -Token $myToRainDropAPITokenString;

PARAMETERS

-Key

Specifies the Execution Key Value.

Type: String
Parameter Sets: (All)
Aliases:

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

-ClientID

(Optional) Specifies the ClientID Value.

Type: String
Parameter Sets: (All)
Aliases:

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

-Token

(Optional) Specifies the APIToken Value.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: 3
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.

INPUTS

[String]$Key

You can pipe [String]$Key objects to Get-ToRainDrop.

OUTPUTS

[PSCustomObject]ToRainDropResult.

NOTES

None.

Get-ToRainDropAPI
New-ToRainDrop
Get-ToRainDrop

Read-ToRainDropResultCmdId

SYNOPSIS

Read CmdId of a ToRainDrop Execution Result.

SYNTAX

Read-ToRainDropResultCmdId [-ToRainDropResult] <PSObject> [<CommonParameters>]

DESCRIPTION

Gets the CmdId String of a ToRainDrop Execution Result.

EXAMPLES

EXAMPLE 1

$myToRainDropResultCmdID = Read-ToRainDropResultCmdId -ToRainDropResult $myToRainDropResult;

EXAMPLE 2

$myToRainDropResultCmdID = $myToRainDropResult | Read-ToRainDropResultCmdId;

PARAMETERS

-ToRainDropResult

Specifies the ToRainDrop Execution Result (PSCustomObject) Value.

Type: PSObject
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByValue)
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.

INPUTS

[PSCustomObject]$ToRainDropResult

You can pipe [PSCustomObject]$ToRainDropResult objects to Read-ToRainDropResultCmdId.

OUTPUTS

[String]ToRainDropResultCmdId.

NOTES

None.

Read-ToRainDropResultCmdId
Read-ToRainDropResultStatus
Read-ToRainDropResultReturns
Read-ToRainDropResultReturnByName

Read-ToRainDropResultStatus

SYNOPSIS

Read Status of a ToRainDrop Execution Result.

SYNTAX

Read-ToRainDropResultStatus [-ToRainDropResult] <PSObject> [<CommonParameters>]

DESCRIPTION

Gets the Result Status String of a ToRainDrop Execution Result.

EXAMPLES

EXAMPLE 1

$myToRainDropResultStatus = Read-ToRainDropResultStatus -ToRainDropResult $myToRainDropResult;

EXAMPLE 2

$myToRainDropResultStatus = $myToRainDropResult | Read-ToRainDropResultStatus;

PARAMETERS

-ToRainDropResult

Specifies the ToRainDrop Execution Result (PSCustomObject) Value.

Type: PSObject
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByValue)
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.

INPUTS

[PSCustomObject]$ToRainDropResult

You can pipe [PSCustomObject]$ToRainDropResult objects to Read-ToRainDropResultStatus.

OUTPUTS

[String]ToRainDropResultStatus.

NOTES

None.

Read-ToRainDropResultCmdId
Read-ToRainDropResultStatus
Read-ToRainDropResultReturns
Read-ToRainDropResultReturnByName

Read-ToRainDropResultReturns

SYNOPSIS

Read All Returns of a ToRainDrop Execution Result.

SYNTAX

Read-ToRainDropResultReturns [-ToRainDropResult] <PSObject> [<CommonParameters>]

DESCRIPTION

Gets all of the Return Values of a ToRainDrop Execution Result.

EXAMPLES

EXAMPLE 1

$myToRainDropResultReturns = Read-ToRainDropResultReturns -ToRainDropResult $myToRainDropResult;

EXAMPLE 2

$myToRainDropResultReturns = $myToRainDropResult | Read-ToRainDropResultReturns;

PARAMETERS

-ToRainDropResult

Specifies the ToRainDrop Execution Result (PSCustomObject) Value.

Type: PSObject
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByValue)
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.

INPUTS

[PSCustomObject]$ToRainDropResult

You can pipe [PSCustomObject]$ToRainDropResult objects to Read-ToRainDropResultReturns.

OUTPUTS

[PSCustomObject]ToRainDropResultReturns.

NOTES

None.

Read-ToRainDropResultCmdId
Read-ToRainDropResultStatus
Read-ToRainDropResultReturns
Read-ToRainDropResultReturnByName

Read-ToRainDropResultReturnByName

SYNOPSIS

Read a Return Value from a ToRainDrop Execution Result Specified by the ReturnName.

SYNTAX

Read-ToRainDropResultReturnByName [-ToRainDropResult] <PSObject> [-ReturnName] <String>
 [-IncludeReturnNameInOutput] [<CommonParameters>]

DESCRIPTION

Gets any matching Return Value from a ToRainDrop Execution Result Specified by the ReturnName.

EXAMPLES

EXAMPLE 1

$myToRainDropResultReturn = Read-ToRainDropResultReturnByName -ToRainDropResult $myToRainDropResult -ReturnName "MyReturnName1";

EXAMPLE 2

$myToRainDropResultReturnWithName = Read-ToRainDropResultReturnByName -ToRainDropResult $myToRainDropResult -ReturnName "MyReturnName1" -IncludeReturnNameInOutput;

EXAMPLE 3

$myToRainDropResultReturn = $myToRainDropResult | Read-ToRainDropResultReturnByName -ReturnName "MyReturnName1";

EXAMPLE 4

$myToRainDropResultReturnWithName = $myToRainDropResult | Read-ToRainDropResultReturnByName -ReturnName "MyReturnName1" -IncludeReturnNameInOutput;

PARAMETERS

-ToRainDropResult

Specifies the ToRainDrop Execution Result (PSCustomObject) Value.

Type: PSObject
Parameter Sets: (All)
Aliases:

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

-ReturnName

Specifies the ReturnName Value.

Type: String
Parameter Sets: (All)
Aliases:

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

-IncludeReturnNameInOutput

(Optional) Specifies the IncludeReturnNameInOutput Switch.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
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.

INPUTS

[PSCustomObject]$ToRainDropResult

You can pipe [PSCustomObject]$ToRainDropResult objects to Read-ToRainDropResultReturns.

OUTPUTS

[PSCustomObject]ToRainDropResultReturns.

NOTES

None.

Read-ToRainDropResultCmdId
Read-ToRainDropResultStatus
Read-ToRainDropResultReturns
Read-ToRainDropResultReturnByName

Get-ToRainDropStatus

SYNOPSIS

Get Result of a ToRainDrop Execution and Read the Status.

SYNTAX

ToRainDropKey

Get-ToRainDropStatus -Key <String> [-ToRainDropResult <PSObject>] [<CommonParameters>]

ToRainDropResult

Get-ToRainDropStatus -ToRainDropResult <PSObject> [-CheckLocalObject] [<CommonParameters>]

DESCRIPTION

Gets the Result Details of a ToRainDrop Execution Specifed and Reads the Status.
(performs a Get-ToRainDrop request to Read the Status)

Prompts ‘Please Enter Client ID’ if no ClientID found for the current ToRainDrop Session.
Prompts ‘Please Enter API Token’ if no APIToken found for the current ToRainDrop Session.

Using the -CheckLocalObject Switch Reads the Status from the (PSObject)$ToRainDropResult passed to the -ToRainDropResult parameter.
(does NOT perform a Get-ToRainDrop request to Read the Status)

EXAMPLES

EXAMPLE 1

$myToRainDropResultStatus = Get-ToRainDropStatus -Key $myToRainDropExecutionKeyCmdIdString;

EXAMPLE 2

$myToRainDropResultStatus = Get-ToRainDropStatus -ToRainDropResult $myToRainDropResult;

EXAMPLE 3

$myToRainDropResultStatus = Get-ToRainDropStatus -ToRainDropResult $myToRainDropResult -CheckLocalObject;

EXAMPLE 4

$myToRainDropResultStatus = $myToRainDropResult | Get-ToRainDropStatus;

EXAMPLE 5

$myToRainDropResultStatus = $myToRainDropResult | Get-ToRainDropStatus -CheckLocalObject;

EXAMPLE 6

$myToRainDropResultStatus = $myToRainDropExecutionKeyCmdIdString | Get-ToRainDrop | Get-ToRainDropStatus -CheckLocalObject;

PARAMETERS

-Key

Specifies the Execution Key Value.
(ParameterSet = “ToRainDropKey”)

Type: String
Parameter Sets: ToRainDropKey
Aliases:

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

-ToRainDropResult

Specifies the ToRainDrop Execution Result (PSCustomObject) Value.
(ParameterSet = “ToRainDropResult”)

Type: PSObject
Parameter Sets: ToRainDropKey
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Type: PSObject
Parameter Sets: ToRainDropResult
Aliases:

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

-CheckLocalObject

Specifies the CheckLocalObject Switch.
(ParameterSet = “ToRainDropResult”)

Type: SwitchParameter
Parameter Sets: ToRainDropResult
Aliases:

Required: False
Position: Named
Default value: False
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.

INPUTS

[PSCustomObject]$ToRainDropResult

You can pipe [PSCustomObject]$ToRainDropResult objects to Get-ToRainDropStatus.

OUTPUTS

[String]ToRainDropResultStatus.

NOTES

Using the -CheckLocalObject Switch Reads the ‘Status Value’ from the (PSObject)$ToRainDropResult passed to the -ToRainDropResult parameter and does NOT perform a Get-ToRainDrop request to Read the ‘Status Value’)

Get-ToRainDropStatus
Get-ToRainDropReturns
Get-ToRainDropReturnByName

Get-ToRainDropReturns

SYNOPSIS

Get Result of a ToRainDrop Execution and Read All Returns.

SYNTAX

ToRainDropKey

Get-ToRainDropReturns -Key <String> [-ToRainDropResult <PSObject>] [<CommonParameters>]

ToRainDropResult

Get-ToRainDropReturns -ToRainDropResult <PSObject> [-CheckLocalObject] [<CommonParameters>]

DESCRIPTION

Gets the Result Details of a ToRainDrop Execution Specifed and Reads all of the Return Values.
(performs a Get-ToRainDrop request to Read the Return Values)

Prompts ‘Please Enter Client ID’ if no ClientID found for the current ToRainDrop Session.
Prompts ‘Please Enter API Token’ if no APIToken found for the current ToRainDrop Session.

Using the -CheckLocalObject Switch Reads the Return Values from the (PSObject)$ToRainDropResult passed to the -ToRainDropResult parameter.
(does NOT perform a Get-ToRainDrop request to Read the Return Values)

EXAMPLES

EXAMPLE 1

$myToRainDropResultReturns = Get-ToRainDropReturns -Key $myToRainDropExecutionKeyCmdIdString;

EXAMPLE 2

$myToRainDropResultReturns = Get-ToRainDropReturns -ToRainDropResult $myToRainDropResult;

EXAMPLE 3

$myToRainDropResultReturns = Get-ToRainDropReturns -ToRainDropResult $myToRainDropResult -CheckLocalObject;

EXAMPLE 4

$myToRainDropResultReturns = $myToRainDropResult | Get-ToRainDropReturns;

EXAMPLE 5

$myToRainDropResultReturns = $myToRainDropResult | Get-ToRainDropReturns -CheckLocalObject;

EXAMPLE 6

$myToRainDropResultReturns = $myToRainDropExecutionKeyCmdIdString | Get-ToRainDrop | Get-ToRainDropReturns -CheckLocalObject;

PARAMETERS

-Key

Specifies the Execution Key Value.
(ParameterSet = “ToRainDropKey”)

Type: String
Parameter Sets: ToRainDropKey
Aliases:

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

-ToRainDropResult

Specifies the ToRainDrop Execution Result (PSCustomObject) Value.
(ParameterSet = “ToRainDropResult”)

Type: PSObject
Parameter Sets: ToRainDropKey
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Type: PSObject
Parameter Sets: ToRainDropResult
Aliases:

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

-CheckLocalObject

Specifies the CheckLocalObject Switch.
(ParameterSet = “ToRainDropResult”)

Type: SwitchParameter
Parameter Sets: ToRainDropResult
Aliases:

Required: False
Position: Named
Default value: False
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.

INPUTS

[PSCustomObject]$ToRainDropResult

You can pipe [PSCustomObject]$ToRainDropResult objects to Get-ToRainDropReturns.

OUTPUTS

[PSCustomObject]ToRainDropResultReturns.

NOTES

Using the -CheckLocalObject Switch Reads the ‘Return Values’ from the (PSObject)$ToRainDropResult passed to the -ToRainDropResult parameter and does NOT perform a Get-ToRainDrop request to Read the ‘Return Values’).

Get-ToRainDropStatus
Get-ToRainDropReturns
Get-ToRainDropReturnByName

Get-ToRainDropReturnByName

SYNOPSIS

Get Result of a ToRainDrop Execution and Reads a Return Value Specified by the ReturnName.

SYNTAX

ToRainDropKey

Get-ToRainDropReturnByName -Key <String> [-ToRainDropResult <PSObject>] -ReturnName <String>
 [-IncludeReturnNameInOutput] [<CommonParameters>]

ToRainDropResult

Get-ToRainDropReturnByName -ToRainDropResult <PSObject> [-CheckLocalObject] -ReturnName <String>
 [-IncludeReturnNameInOutput] [<CommonParameters>]

DESCRIPTION

Gets the Result Details of a ToRainDrop Execution Specifed and Reads any matching Return Value specified by the ReturnName.
(performs a Get-ToRainDrop request to Read the Return Value)

Prompts ‘Please Enter Client ID’ if no ClientID found for the current ToRainDrop Session.
Prompts ‘Please Enter API Token’ if no APIToken found for the current ToRainDrop Session.

Using the -CheckLocalObject Switch Reads the Return Values from the (PSObject)$ToRainDropResult passed to the -ToRainDropResult parameter.
(does NOT perform a Get-ToRainDrop request to Read the matching Return Value)

EXAMPLES

EXAMPLE 1

$myToRainDropResultReturn = Get-ToRainDropReturnByName -Key $myToRainDropExecutionKeyCmdIdString -ReturnName "MyReturnName1";

EXAMPLE 2

$myToRainDropResultReturn = Get-ToRainDropReturnByName -ToRainDropResult $myToRainDropResult -ReturnName "MyReturnName1";

EXAMPLE 3

$myToRainDropResultReturn = Get-ToRainDropReturnByName -ToRainDropResult $myToRainDropResult -CheckLocalObject -ReturnName "MyReturnName1";

EXAMPLE 4

$myToRainDropResultReturn = $myToRainDropResult | Get-ToRainDropReturnByName -ReturnName "MyReturnName1";

EXAMPLE 5

$myToRainDropResultReturn = $myToRainDropResult | Get-ToRainDropReturnByName -CheckLocalObject -ReturnName "MyReturnName1";

EXAMPLE 6

$myToRainDropResultReturn = $myToRainDropExecutionKeyCmdIdString | Get-ToRainDrop | Get-ToRainDropReturnByName -CheckLocalObject -ReturnName "MyReturnName1";

EXAMPLE 7

$myToRainDropResultReturnWithName = Get-ToRainDropReturnByName -ToRainDropResult $myToRainDropResult -CheckLocalObject -ReturnName "MyReturnName1" -IncludeReturnNameInOutput;

EXAMPLE 8

$myToRainDropResultReturnWithName = $myToRainDropResult | Get-ToRainDropReturnByName -CheckLocalObject -ReturnName "MyReturnName1" -IncludeReturnNameInOutput;

PARAMETERS

-Key

Specifies the Execution Key Value.
(ParameterSet = “ToRainDropKey”)

Type: String
Parameter Sets: ToRainDropKey
Aliases:

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

-ToRainDropResult

Specifies the ToRainDrop Execution Result (PSCustomObject) Value.
(ParameterSet = “ToRainDropResult”)

Type: PSObject
Parameter Sets: ToRainDropKey
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Type: PSObject
Parameter Sets: ToRainDropResult
Aliases:

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

-CheckLocalObject

Specifies the CheckLocalObject Switch.
(ParameterSet = “ToRainDropResult”)

Type: SwitchParameter
Parameter Sets: ToRainDropResult
Aliases:

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

-ReturnName

Specifies the ReturnName Value.

Type: String
Parameter Sets: (All)
Aliases:

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

-IncludeReturnNameInOutput

(Optional) Specifies the IncludeReturnNameInOutput Switch.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: False
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.

INPUTS

[PSCustomObject]$ToRainDropResult

You can pipe [PSCustomObject]$ToRainDropResult objects to Read-ToRainDropResultReturns.

OUTPUTS

[PSCustomObject]ToRainDropResultReturns.

NOTES

Using the -CheckLocalObject Switch Reads the ‘Return Values’ from the (PSObject)$ToRainDropResult passed to the -ToRainDropResult parameter and does NOT perform a Get-ToRainDrop request to Read the ‘Return Values’).

Get-ToRainDropStatus
Get-ToRainDropReturns
Get-ToRainDropReturnByName