New-BEFileSystemSelection Help

Synopsis

Creates a backup selection object for NTFS file system selections.

Syntax

New-BEFileSystemSelection [-Path] [<String>] [-IncludeOnlyModifiedFiles [<SwitchParameter>]] [-IncludeOnlyReadOnlyFiles [<SwitchParameter>]] [-NumberOfDaysFilesNotAccessed [<Int32>]] [-PathIsDirectory [<SwitchParameter>]] [-Recurse [<SwitchParameter>]] [-Exclude [<SwitchParameter>]] [<CommonParameters>]

New-BEFileSystemSelection [-Path] [<String>] -FromDate [<DateTime>] [-IncludeOnlyReadOnlyFiles [<SwitchParameter>]] [-NumberOfDaysFilesNotAccessed [<Int32>]] [-ToDate [<DateTime>]] [-Recurse [<SwitchParameter>]] [-PathIsDirectory [<SwitchParameter>]] [-IncludeOnlyModifiedFiles [<SwitchParameter>]] [-Exclude [<SwitchParameter>]] [<CommonParameters>]

Description

Creates a backup selection object for NTFS file system selections.

Parameters

-Path <String>

Specifies the path of the file system folder or file that you want to select. Wildcards accepted.

Required	true
Position	0
Accepts pipeline input	true (ByValue ByPropertyName)
Accepts wildcard characters	false

-PathIsDirectory <SwitchParameter>

Specifies that the value of the Path parameter is a directory instead of a file.

Required	false
Position	Named
Accepts pipeline input	true (ByPropertyName)
Accepts wildcard characters	false

-Recurse <SwitchParameter>

Specifies if you want to select all subfolders.

Required	false
Position	Named
Accepts pipeline input	false
Accepts wildcard characters	false

-Exclude <SwitchParameter>

Excludes the filesystem selection specified by the -Path parameter.

Required	false
Position	Named
Accepts pipeline input	false
Accepts wildcard characters	false

-IncludeOnlyModifiedFiles <SwitchParameter>

Specifies that you want to select only the files modified since the previous backup.

Required	false
Position	Named
Accepts pipeline input	false
Accepts wildcard characters	false

-IncludeOnlyReadOnlyFiles <SwitchParameter>

Specifies if you want to select only the files that are read-only.

Required	false
Position	Named
Accepts pipeline input	false
Accepts wildcard characters	false

-FromDate <DateTime>

Specifies a DateTime object to filter files with a timestamp that is after the specified DateTime.

Required	true
Position	Named
Accepts pipeline input	false
Accepts wildcard characters	false

-ToDate <DateTime>

Specifies a DateTime object to filter files with a timestamp that is before the specified DateTime. If the FromDate parameter is specified but the ToDate parameter is not specified, the ToDate parameter is automatically set to the current day at 11:59:59 PM. The FromDate parameter must be before the ToDate parameter.

Required	false
Position	Named
Accepts pipeline input	false
Accepts wildcard characters	false

-NumberOfDaysFilesNotAccessed <Int32>

Specifies the number of days to filter files that have not been accessed.

Required	false
Position	Named
Accepts pipeline input	false
Accepts wildcard characters	false

For more information about common parameters, type "Get-Help about_commonparameters".

Input Type

System.String

You can pipe a string object to New-BEFileSystemSelection.

Return Value

BackupExec.Management.CLI.BEFileSystemSelection

New-BEFileSystemSelection returns a BEFileSystemSelection object.

Examples

Example 1

C:\PS> $x = New-BEFileSystemSelection -Path "C:\*" -Recurse
C:\PS> Get-BEAgentServer -Local | New-BEBackupDefinition -BackupJobDefault BackupToDisk -FileSystemSelection $x | Save-BEBackupDefinition

These commands create a backup definition that backs up the C: volume for the local computer using the "BackupToDisk" job defaults.

Example 2

C:\PS> $x = "C:\Windows\*" | New-BEFileSystemSelection -Recurse -Exclude
C:\PS> Get-BEAgentServer -Local | Submit-BEOnetimeBackupJob -FileSystemSelection $x

These commands submit a one-time backup that backs up all of the data on the local computer with the exception of the C:\Windows directory.