New-FilesScheduledExport

Create Scheduled Export.

Syntax

New-FilesScheduledExport -Name <System.String> -ExportType <System.String> [-ExportOptions <System.Collections.IDictionary>] [-UserId <System.Int64>] [-Disabled <System.Boolean>] [-Trigger <System.String>] [-Interval <System.String>] [-RecurringDay <System.Int64>] [-RecurringDays <System.Int64[]>] [-ScheduleId <System.Int64>] [-ScheduleDaysOfWeek <System.Int64[]>] [-ScheduleTimesOfDay <System.String[]>] [-ScheduleTimeZone <System.String>] [-HolidayRegion <System.String>] [-Connection <FilesCom.PowerShell.FilesConnection>] [-WorkspaceScope <System.Int64>] [-NoWorkspaceScope] [-WhatIf] [-Confirm] [<CommonParameters>]

Description

Create Scheduled Export.

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

Examples

Example 1: Create Scheduled Export

New-FilesScheduledExport -Name 'Monthly access review' -ExportType 'permission_audit' -ExportOptions @{ group_by = 'user' } -UserId 1

Writes the scheduled export returned.

Example 2: Preview the change

New-FilesScheduledExport -Name 'Monthly access review' -ExportType 'permission_audit' -ExportOptions @{ group_by = 'user' } -UserId 1 -WhatIf

Describes the change without sending anything to Files.com.

Parameters

-Name

Name for this scheduled export.

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

-ExportType

Export report type. Valid values: folder_size_audit, group_membership_audit, permission_audit, share_link_audit

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

-ExportOptions

Report-specific options. permission_audit supports group_by with user or path. Give a hashtable or PSCustomObject; keys keep their case and values their types.

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

-UserId

Site Admin user who receives the completed export e-mail.

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

-Disabled

If true, this scheduled export will not run.

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

-Trigger

Schedule trigger type: daily or custom_schedule.

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

-Interval

If trigger is daily, this specifies how often to run the scheduled export.

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

-RecurringDay

If trigger is daily, this selects the day number inside the chosen interval.

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

-RecurringDays

If trigger is daily, this selects one or more day numbers inside a week, month, quarter, or year interval.

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

-ScheduleId

If trigger is custom_schedule, the reusable Schedule used instead of the scheduled export's schedule fields.

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

-ScheduleDaysOfWeek

If trigger is custom_schedule, the 0-based weekdays used by the schedule.

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

-ScheduleTimesOfDay

Times of day in HH:MM format for the scheduled export schedule.

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

-ScheduleTimeZone

Time zone used by the scheduled export schedule.

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

-HolidayRegion

Optional holiday region used by the scheduled export schedule.

  • 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

  • FilesCom.PowerShell.Models.ScheduledExport: the scheduled export 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.