Move-MgBetaPlannerPlanToContainer

Move a planner plan object from one planner plan container to another. Planner plans can only be moved from a user container to a group container.

Syntax

Move-MgBetaPlannerPlanToContainer
    -PlannerPlanId <String>
    [-ResponseHeadersVariable <String>]
    [-AdditionalProperties <Hashtable>]
    [-Container <IMicrosoftGraphPlannerPlanContainer>]
    [-Headers <IDictionary>]
    [-ProgressAction <ActionPreference>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Move-MgBetaPlannerPlanToContainer
    -PlannerPlanId <String>
    -BodyParameter <IPathsXmyifhPlannerPlansPlannerplanIdMicrosoftGraphMovetocontainerPostRequestbodyContentApplicationJsonSchema>
    [-ResponseHeadersVariable <String>]
    [-Headers <IDictionary>]
    [-ProgressAction <ActionPreference>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Move-MgBetaPlannerPlanToContainer
    -InputObject <IPlannerIdentity>
    [-ResponseHeadersVariable <String>]
    [-AdditionalProperties <Hashtable>]
    [-Container <IMicrosoftGraphPlannerPlanContainer>]
    [-Headers <IDictionary>]
    [-ProgressAction <ActionPreference>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Move-MgBetaPlannerPlanToContainer
    -InputObject <IPlannerIdentity>
    -BodyParameter <IPathsXmyifhPlannerPlansPlannerplanIdMicrosoftGraphMovetocontainerPostRequestbodyContentApplicationJsonSchema>
    [-ResponseHeadersVariable <String>]
    [-Headers <IDictionary>]
    [-ProgressAction <ActionPreference>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Move a planner plan object from one planner plan container to another. Planner plans can only be moved from a user container to a group container.

Permissions

Permission type Least privileged permissions Higher privileged permissions
Delegated (work or school account) Tasks.Read Tasks.ReadWrite
Delegated (personal Microsoft account) Not supported. Not supported.
Application Tasks.Read.All Tasks.ReadWrite.All

Examples

Example 1: Code snippet

Import-Module Microsoft.Graph.Beta.Planner

$params = @{
	container = @{
		containerId = "groupId"
		type = "group"
	}
}

Move-MgBetaPlannerPlanToContainer -PlannerPlanId $plannerPlanId -BodyParameter $params

This example shows how to use the Move-MgBetaPlannerPlanToContainer Cmdlet.

Parameters

-AdditionalProperties

Additional Parameters

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

-BodyParameter

. To construct, see NOTES section for BODYPARAMETER properties and create a hash table.

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

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Container

plannerPlanContainer To construct, see NOTES section for CONTAINER properties and create a hash table.

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

-Headers

Optional headers that will be added to the request.

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

-InputObject

Identity Parameter To construct, see NOTES section for INPUTOBJECT properties and create a hash table.

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

-PlannerPlanId

The unique identifier of plannerPlan

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

-ProgressAction

{{ Fill ProgressAction Description }}

Type:ActionPreference
Aliases:proga
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResponseHeadersVariable

Optional Response Headers Variable.

Type:String
Aliases:RHV
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

Microsoft.Graph.Beta.PowerShell.Models.IPathsXmyifhPlannerPlansPlannerplanIdMicrosoftGraphMovetocontainerPostRequestbodyContentApplicationJsonSchema

Microsoft.Graph.Beta.PowerShell.Models.IPlannerIdentity

System.Collections.IDictionary

Outputs

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphPlannerPlan

Notes

COMPLEX PARAMETER PROPERTIES

To create the parameters described below, construct a hash table containing the appropriate properties. For information on hash tables, run Get-Help about_Hash_Tables.

BODYPARAMETER <IPathsXmyifhPlannerPlansPlannerplanIdMicrosoftGraphMovetocontainerPostRequestbodyContentApplicationJsonSchema>: .

  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [Container <IMicrosoftGraphPlannerPlanContainer>]: plannerPlanContainer
    • [(Any) <Object>]: This indicates any property can be added to this object.
    • [ContainerId <String>]: The identifier of the resource that contains the plan. Optional.
    • [Type <String>]: plannerContainerType
    • [Url <String>]: The full canonical URL of the container. Optional.

CONTAINER <IMicrosoftGraphPlannerPlanContainer>: plannerPlanContainer

  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [ContainerId <String>]: The identifier of the resource that contains the plan. Optional.
  • [Type <String>]: plannerContainerType
  • [Url <String>]: The full canonical URL of the container. Optional.

INPUTOBJECT <IPlannerIdentity>: Identity Parameter

  • [GroupId <String>]: The unique identifier of group
  • [PlannerBucketId <String>]: The unique identifier of plannerBucket
  • [PlannerDeltaId <String>]: The unique identifier of plannerDelta
  • [PlannerPlanId <String>]: The unique identifier of plannerPlan
  • [PlannerRosterId <String>]: The unique identifier of plannerRoster
  • [PlannerRosterMemberId <String>]: The unique identifier of plannerRosterMember
  • [PlannerTaskId <String>]: The unique identifier of plannerTask
  • [UserId <String>]: The unique identifier of user