Set-FilesClickwrap

Update Clickwrap.

Syntax

Id (Default)

Set-FilesClickwrap [-Id] <System.Int64> [-Name <System.String>] [-Body <System.String>] [-UseWithBundles <System.String>] [-UseWithInboxes <System.String>] [-UseWithUsers <System.String>] [-Connection <FilesCom.PowerShell.FilesConnection>] [-WorkspaceScope <System.Int64>] [-NoWorkspaceScope] [-WhatIf] [-Confirm] [<CommonParameters>]

InputObject

Set-FilesClickwrap [-Name <System.String>] [-Body <System.String>] [-UseWithBundles <System.String>] [-UseWithInboxes <System.String>] [-UseWithUsers <System.String>] -InputObject <FilesCom.PowerShell.Models.Clickwrap> [-Connection <FilesCom.PowerShell.FilesConnection>] [-WorkspaceScope <System.Int64>] [-NoWorkspaceScope] [-WhatIf] [-Confirm] [<CommonParameters>]

Description

Update Clickwrap.

The command accepts clickwraps from the pipeline as -InputObject, and uses each one's Id and the connection that fetched it.

When given -InputObject, the command updates that object with the values Files.com returns and writes it.

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

Examples

Example 1: Update Clickwrap

Set-FilesClickwrap -Id 1 -Name 'Example Site NDA for Files.com Use' -Body '[Legal body text]'

Writes the clickwrap as Files.com returns it.

Example 2: Act on clickwraps from the pipeline

Get-FilesClickwrap -Id 1 | Set-FilesClickwrap -Name 'Example Site NDA for Files.com Use' -Body '[Legal body text]'

Takes the clickwrap from the pipeline and uses its Id and connection.

Example 3: Preview the change

Set-FilesClickwrap -Id 1 -Name 'Example Site NDA for Files.com Use' -Body '[Legal body text]' -WhatIf

Describes the change without sending anything to Files.com.

Parameters

-Id

Clickwrap ID.

  • Type: System.Int64
  • Parameter sets: Id (required, position 0)

-Name

Name of the Clickwrap agreement (used when selecting from multiple Clickwrap agreements.)

  • Type: System.String
  • Parameter sets: Id, InputObject

-Body

Body text of Clickwrap (supports Markdown formatting).

  • Type: System.String
  • Parameter sets: Id, InputObject

-UseWithBundles

Use this Clickwrap for Bundles?

  • Type: System.String
  • Parameter sets: Id, InputObject

-UseWithInboxes

Use this Clickwrap for Inboxes?

  • Type: System.String
  • Parameter sets: Id, InputObject

-UseWithUsers

Use this Clickwrap for Users? Values: none, require (new user signup via email invitation only), require_all_users_once (show to all users at their next web login; once accepted, not shown again), require_all_users_always (show to all users on every web login).

  • Type: System.String
  • Parameter sets: Id, InputObject

-InputObject

The clickwrap to act on, such as one written by another command of the module, from the pipeline. The command uses its Id and the connection that fetched it.

  • Type: FilesCom.PowerShell.Models.Clickwrap
  • Parameter sets: InputObject (required)

-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

  • FilesCom.PowerShell.Models.Clickwrap: a clickwrap from another command of the module, as -InputObject.

Outputs

  • FilesCom.PowerShell.Models.Clickwrap: the clickwrap as Files.com returned it.

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.