Test-FilesBehaviorWebhook

Test Webhook.

Syntax

Test-FilesBehaviorWebhook -Url <System.String> [-Method <System.String>] [-Encoding <System.String>] [-Headers <System.Collections.IDictionary>] [-Body <System.Collections.IDictionary>] [-Action <System.String>] [-Connection <FilesCom.PowerShell.FilesConnection>] [-WorkspaceScope <System.Int64>] [-NoWorkspaceScope] [-WhatIf] [-Confirm] [<CommonParameters>]

Description

Test Webhook.

The command supports -WhatIf, which describes the change without sending it to Files.com, and -Confirm, which asks before sending it.

Examples

Example 1: Test Webhook

Test-FilesBehaviorWebhook -Url 'https://www.site.com/...' -Method 'GET' -Encoding 'RAW'

Sends the request and writes nothing when it succeeds.

Example 2: Preview the change

Test-FilesBehaviorWebhook -Url 'https://www.site.com/...' -Method 'GET' -Encoding 'RAW' -WhatIf

Describes the change without sending anything to Files.com.

Parameters

-Url

URL for testing the webhook.

  • Type: System.String
  • Parameter sets: (All) (required)

-Method

HTTP request method (GET or POST).

  • Type: System.String
  • Parameter sets: (All)

-Encoding

Encoding type for the webhook payload. Can be JSON, XML, or RAW (form data).

  • Type: System.String
  • Parameter sets: (All)

-Headers

Additional request headers to send via HTTP. Give a hashtable or PSCustomObject; keys keep their case and values their types.

  • Type: System.Collections.IDictionary
  • Parameter sets: (All)

-Body

Additional body parameters to include in the webhook payload. Give a hashtable or PSCustomObject; keys keep their case and values their types.

  • Type: System.Collections.IDictionary
  • Parameter sets: (All)

-Action

Action for test body.

  • Type: System.String
  • Parameter sets: (All)

-Connection

The connection to use, from Connect-FilesAccount. Defaults to the connection of the -InputObject or -Continuation given, and otherwise to the current runspace's default connection.

  • Type: FilesCom.PowerShell.FilesConnection
  • Parameter sets: (All)

-WorkspaceScope

Runs this command's requests in this workspace, including workspace 0, instead of the connection's or, for an -InputObject, instead of the workspace the object was read in. The connection and the object are unchanged.

  • Type: System.Int64
  • Parameter sets: (All)

-NoWorkspaceScope

Runs this command's requests in no workspace, even if the connection has one. The connection itself is unchanged.

  • Type: System.Management.Automation.SwitchParameter
  • Parameter sets: (All)

-Confirm

Prompts you for confirmation before running the cmdlet.

  • Type: System.Management.Automation.SwitchParameter
  • Confirm impact: Medium. At the default $ConfirmPreference of High, the command runs without asking; -Confirm makes it ask before each change.

-WhatIf

Shows what the cmdlet would change without sending anything to Files.com.

  • Type: System.Management.Automation.SwitchParameter

Common Parameters

This cmdlet supports the PowerShell common parameters, such as -Verbose and -ErrorAction.

Inputs

None. The command takes no pipeline input.

Outputs

None. The command writes nothing when it succeeds.

Notes

Failures are written as error records with IDs such as Files.NotFound or Files.Authentication. Run Get-Help about_FilesCom for connections, paging, errors and previewing changes.