Command
Copy-PlannerPlan
Description
The command to copy plans from a Microsoft 365 group to another Microsoft 365 group. The destination group can be on the same or a different tenant.
Index
Examples
Copy a plan
$sourceTenant = Connect-Tenant -Domain tenantDomain $sourceGroup = Get-Microsoft365Group -Name "MyGroup" -Tenant $sourceTenant $plan = Get-PlannerPlan -Name "MyPlan" -Group $sourceGroup $destinationTenant = Connect-Tenant -Domain destinationDomain $destinationGroup = Get-Microsoft365Group -Name "DestinationGroup" -Tenant $destinationTenant Copy-PlannerPlan -PlannerPlans $plan -DestinationGroup $destinationGroup
Copy multiple plans
$sourceTenant = Connect-Tenant -Domain tenantDomain $sourceGroup = Get-Microsoft365Group -Name "MyGroup" -Tenant $sourceTenant $plans = Get-PlannerPlan -Name "MyPlan", "MyPlan2", "MyPlan3" -Group $sourceGroup -AllowMultiple $destinationTenant = Connect-Tenant -Domain destinationDomain $destinationGroup = Get-Microsoft365Group -Name "DestinationGroup" -Tenant $destinationTenant Copy-PlannerPlan -PlannerPlans $plans -DestinationGroup $destinationGroup
Copy all plans from a group
$sourceTenant = Connect-Tenant -Domain tenantDomain $sourceGroup = Get-Microsoft365Group -Name "MyGroup" -Tenant $sourceTenant $plans = Get-PlannerPlan -Name "*" -Group $sourceGroup -AllowMultiple $destinationTenant = Connect-Tenant -Domain destinationDomain $destinationGroup = Get-Microsoft365Group -Name "DestinationGroup" -Tenant $destinationTenant Copy-PlannerPlan -PlannerPlans $plans -DestinationGroup $destinationGroup
Copy a plan with options
$sourceTenant = Connect-Tenant -Domain tenantDomain $sourceGroup = Get-Microsoft365Group -Name "MyGroup" -Tenant $sourceTenant $plan = Get-PlannerPlan -Name "MyPlan" -Group $sourceGroup $destinationTenant = Connect-Tenant -Domain destinationDomain $destinationGroup = Get-Microsoft365Group -Name "DestinationGroup" -Tenant $destinationTenant $options = New-PlannerCopyOptions -CopyScope OnlyBuckets -IncludeMembership Copy-PlannerPlan -PlannerPlans $plan -DestinationGroup $destinationGroup
Syntax
Copy-PlannerPlan-PlannerPlans <PlannerPlan[]>-DestinationGroup <Microsoft365Group>[-CopyOptions <PlannerCopyOptions>][-NormalMode <SwitchParameter>][-MappingSettings <MappingSettings>][-TaskName <String>]
You can get the syntax of any command in PowerShell with this script:
Get-Command Copy-Site -SyntaxParameters
Parameters
-CopyOptions <PlannerCopyOptions>
Specifies the copy options (scope of copy).
Required? | False |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |
-DestinationGroup <Microsoft365Group>
Specifies the destination M365 Group.
Required? | True |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |
-MappingSettings <MappingSettings>
Specifies the mapping settings.
Required? | False |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |
-NormalMode <SwitchParameter>
Specifies that the normal mode should be used.
Note: Insane mode is always used by default in PowerShell.
Required? | False |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |
-PlannerPlans <PlannerPlan[]>
Specifies the Planner plans.
Required? | True |
Default value | None |
Accept pipeline input? | True (ByValue, ByPropertyName) |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |
-TaskName <String>
Specifies a name for the task.
Required? | False |
Default value | None |
Accept pipeline input? | False |
Accept wildcard characters? | False |
Parameter set name | (All) |
Aliases | None |