Show-M365UserDrive

SYNOPSIS

Shows a user drive in a Microsoft 365 tenant or Microsoft consumer account.

SYNTAX

Action (Default)

Show-M365UserDrive [-SourceFolder <String>] [-IncludePattern <String>] [-NoCache] [-Verbosity <String>]
 [<CommonParameters>]

Help

Show-M365UserDrive [-ShowPrereqs] [<CommonParameters>]

DESCRIPTION

Use the Show-M365UserDrive cmdlet to show a user drive in a Microsoft 365 tenant or Microsoft consumer account.

This cmdlet uses an interactive, browser-based authentication flow and is most commonly used when you do not have administrative credentials (e.g., consumer accounts).

See the Examples section for cmdlet requirements.

EXAMPLES

Example 1: Show entire Microsoft consumer drive

Description

This example shows a Microsoft consumer drive.

Tenant configuration

No tenant configuration is required.

TMCTools

@{
  Source = @{}
}

Show-M365UserDrive

Example 2: Show entire Microsoft 365 tenant drive

Description

This example shows a Microsoft 365 tenant drive.

Tenant configuration

No tenant configuration is required.

TMCTools

@{
  Source = @{
    M365Tenant = 'source.org'
  }
}

Show-M365UserDrive

Example 3: Show folder in Microsoft consumer drive

Description

This example shows a named folder in a Microsoft consumer drive.

Additional parameters change the basic functionality shown in Example 1:

• Using -SourceFolder restricts the operation to the Migration folder.

Tenant configuration

No tenant configuration is required.

TMCTools

@{
  Source = @{}
}

Show-M365UserDrive -SourceFolder 'Migration'

PARAMETERS

-IncludePattern

A matching pattern to determine which folders and files to include. See https://rclone.org/filtering/ for syntax details.

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

-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

-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

• Transend apps are used to generate tokens and are subject to shared throttling. If you can create apps in the source tenant, consider using Show-M365UserDrives instead.

RELATED LINKS

TMCTools configuration options