Compare-DBXUserDrive

SYNOPSIS

Use the Compare-DBXUserDrive cmdlet to compare the contents of a single Dropbox user drive.

SYNTAX

Help

Compare-DBXUserDrive
  -Target <String>
  [-ShowPrereqs]
  [<CommonParameters>]

Action

Compare-DBXUserDrive
  -Target <String>
  [-TargetId <String>]
  [-SourceFolder <String>]
  [-TargetFolder <String>]
  [-IncludePattern <String>]
  [-ExcludePattern <String>]
  [-MaxAge <String>]
  [-MinAge <String>]
  [-OneWay]
  [-NoCache]
  [-Verbosity <String>]
  [<CommonParameters>]

DESCRIPTION

Use this cmdlet to compare the contents of a single user drive pair.

See the Examples section for cmdlet requirements.

EXAMPLES

Example 1: Compare contents to Google Workspace user drive

Description

This example compares the contents of a user drive to a paired user drive in Google Workspace.

Provider configuration

No provider configuration is required.

TMCTools

@{
  Source = @{}
  Target = @{}
}

Compare-DBXUserDrive -Target Google

Example 2: Compare contents to Microsoft 365 user drive

Description

This example compares the contents of a user drive to a paired user drive in Microsoft 365.

Provider configuration

No provider configuration is required.

TMCTools

@{
  Source = @{}
  Target = @{}
}

Compare-DBXUserDrive -Target M365

Example 3: Compare contents to filesystem user drive

Description

This example compares the contents of a user drive to a paired user drive in the local filesystem.

Provider configuration

No provider configuration is required.

TMCTools

@{
  Source = @{}
  Target = @{}
}

Compare-DBXUserDrive -Target Windows -TargetId '<DRIVE_PATH>'

PARAMETERS

-ExcludePattern

A matching pattern to determine which folders and files to exclude. Syntax details can be found here.

Type: String
Parameter Sets: Action
Aliases:

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

-IncludePattern

A matching pattern to determine which folders and files to include. Syntax details can be found here.

Type: String
Parameter Sets: Action
Aliases:

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

-MaxAge

The maximum age (modified time) of files to include. Syntax details can be found here.

Type: String
Parameter Sets: Action
Aliases:

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

-MinAge

The minimum age (modified time) of files to include. Syntax details can be found here.

Type: String
Parameter Sets: Action
Aliases:

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

-NoCache

Refresh tokens obtained from a prior authentication will be used by default. If you are running different tools that require different permissions or want to log in as a different user, use the -NoCache option to bypass an existing refresh token.

Type: SwitchParameter
Parameter Sets: Action
Aliases:

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

-OneWay

All regular files in the source and target are included by default. Use -OneWay to restrict files to the source only. This is useful when migrating data, when you only care that files from the source are migrated to the target and do not want to consider pre-existing target files.

Type: SwitchParameter
Parameter Sets: Action
Aliases:

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

-ShowPrereqs

Prints the cmdlet prerequisites.

Type: SwitchParameter
Parameter Sets: Help
Aliases:

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

-SourceFolder

Restrict the source-side listing to the specified folder.

Type: String
Parameter Sets: Action
Aliases:

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

-Target

The target provider.

Type: String
Parameter Sets: (All)
Aliases:
Accepted values: Dropbox, Google, M365, Windows

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

-TargetFolder

Restrict the target-side listing to the specified folder.

Type: String
Parameter Sets: Action
Aliases:

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

-TargetId

The full path to a local drive. For example, C:\Drives\user@target.org.

This parameter only applies when -Target is Windows.

Type: String
Parameter Sets: Action
Aliases:

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

-Verbosity

The amount of detail logged during processing.

Type: String
Parameter Sets: Action
Aliases:
Accepted values: None, Normal, Detailed, Diagnostic

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

System.Void

NOTES

Optional config.psd1 keys

These configuration keys are scoped to the Source node in config.psd1.

• DBXClientId: The client ID of your tenant’s app.

• DBXClientSecret: The client secret of your tenant’s app.

These configuration keys are scoped to the Target node in config.psd1.

• DBXClientId: The client ID of your tenant’s app. Only applies to a Dropbox target.

• DBXClientSecret: The client secret of your tenant’s app. Only applies to a Dropbox target.

• GOClientId: The client ID of your tenant’s app. Only applies to a Google Workspace target.

• GOClientSecret: The client secret of your tenant’s app. Only applies to a Google Workspace target.

• M365ClientId: The client ID of your tenant’s app. Only applies to a Microsoft 365 target.

• M365ClientSecret: The client secret of your tenant’s app. Only applies to a Microsoft 365 target.

• M365CloudEnvironment: The cloud environment for your tenant. Allowed values are Global, China (.cn), Germany (.de) and USGovernment (.us). Only applies to a Microsoft 365 target.

  Default: Global

• M365Tenant: The ID of your tenant. For example, target.org. Only applies to a Microsoft 365 target.

Required APIs

See the Examples section for details.

Required scopes

See the Examples section for details.

RELATED LINKS

General configuration options