Logo

Documentation home for Transend tools

  • Export-M365Applications
  • Export-M365Domains
  • Export-M365Groups
  • Export-M365Mailboxes
  • Export-M365OrgLicenses
  • Export-M365OrgUnits
  • Export-M365Resources
  • Export-M365SharedContacts
  • Export-M365SharedDrives
  • Export-M365SharedMailboxes
  • Export-M365Sites
  • Export-M365Users
  • Import-M365Groups
  • Import-M365Resources
  • Import-M365SharedContacts
  • Import-M365SharedMailboxes
  • Import-M365UserDrives
  • Import-M365Users
  • Update-M365Groups
  • Update-M365Resources
  • Update-M365SharedContacts
  • Update-M365SharedMailboxes
  • Update-M365Users

    • Home

    Import-M365UserDrives

    SYNOPSIS

    Imports user drives into a Microsoft 365 tenant.

    SYNTAX

    Help (Default)

    Import-M365UserDrives [-ShowPrereqs] [<CommonParameters>]

    Action

    Import-M365UserDrives -ConfigNode <String> -Csv <String> [-TranslationCsv <String>] [-BatchSize <Int32>]
 [-IgnoreErrors] [-SkipValidation] [-ValidateOnly] [<CommonParameters>]

    DESCRIPTION

    Use the Import-M365UserDrives cmdlet to import user drives into a Microsoft 365 tenant.

    See the Notes section for cmdlet requirements.

    EXAMPLES

    Example 1: Validation only

    Import-M365UserDrives -ConfigNode Target -Csv 'user_drives.csv' -ValidateOnly

    This example validates all data for the user drives in the user_drives.csv file but does not perform the operation. This is a recommended first step so any warnings can be addressed first.

    Example 2: Basic import

    Import-M365UserDrives -ConfigNode Target -Csv 'user_drives.csv'

    This example imports all user drives from the user_drives.csv.

    Example 3: Advanced import with translation

    Import-M365UserDrives -ConfigNode Target -Csv 'user_drives.csv' -TranslationCsv 'translations.csv'

    This example imports all user drives from the user_drives.csv file. Data is translated according to the mappings provided in the translations.csv file.

    PARAMETERS

    -BatchSize

    The number of user drives to import per batch. If not specified, the maximum of 200 user drives is used.

    Type: Int32
Parameter Sets: Action
Aliases:

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

    -ConfigNode

    The config.psd1 configuration node to use.

    Type: String
Parameter Sets: Action
Aliases:
Accepted values: Source, Target

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

    -Csv

    The path to a CSV file containing objects to import. See the Notes section for the required format.

    Type: String
Parameter Sets: Action
Aliases:

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

    -IgnoreErrors

    Validation errors stop execution prior to the import by default. Use -IgnoreErrors to proceed with error records omitted.

    Note that global errors are not impacted by this option.

    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

    -SkipValidation

    Skips the property validation stage of the import. Data supplied in the via the -Csv parameter will be used as-is, which may lead to runtime errors.

    Type: SwitchParameter
Parameter Sets: Action
Aliases:

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

    -TranslationCsv

    The path to the CSV file containing translation mappings. The file must use SourceName;TargetName as the field identifiers.

    Type: String
Parameter Sets: Action
Aliases:

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

    -ValidateOnly

    Validation and import are both performed by default. Use -ValidateOnly to perform the validation but skip the import.

    It is recommended to run a -ValidateOnly pass first to identify potential issues prior to importing data. Note that records with validation errors will fail to import unless -IgnoreErrors is used, but records with validation warnings proceed without the data triggering the warning. A -ValidateOnly pass allows you to inspect these warnings before data is written and make any necessary changes.

    Type: SwitchParameter
Parameter Sets: Action
Aliases:

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

    Required PowerShell modules

    • ExchangeOnlineManagement
    • Microsoft.Online.SharePoint.PowerShell

    Note that you must install the SharePoint module using Windows PowerShell (PowerShell 5.1 or earlier) even though you need to run Import-M365UserDrives using PowerShell 7.0 or later.

    Required config.psd1 configurations

    • M365ClientId
    • M365ClientSecret
    • M365SharePointDomain
    • M365Tenant

    Optional config.psd1 configurations

    • M365CloudEnvironment

    Required APIs

    • Microsoft Graph

    Required scopes

    • Directory.Read.All (Application)

    Required CSV format

    Property Required Multivalue Notes
    InScope True False Allowed values: Yes, True, No and False
    Identity True False Allowed values: OID, UPN, email address, email alias, display name
    • CSV fields should be separated by semicolons. For example, InScope;Identity....

    TMCTools configuration options